home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / treevw11.zip / TV.DOC < prev    next >
Text File  |  1989-05-31  |  127KB  |  3,129 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                   TREEVIEW (TM)
  14.  
  15.  
  16.  
  17.                     The Ultimate File Management Utility (TM)
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                                    Version 1.1
  29.  
  30.  
  31.  
  32.                                 May, 1989 Release
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                    Copyright 1988, 1989 Magee Enterprises, Inc.
  61. ISBN 0-938167-01-4
  62.  
  63.  
  64. Copyright 1988, 1989 Magee Enterprises, Inc.
  65. All Rights Reserved Worldwide.
  66. A product of the United States of America.
  67.  
  68.  
  69. Treeview(TM) is a trademark of Magee Enterprises, Inc. All trademarks and
  70. registered trademarks referenced within this document are the property of
  71. their respective owners.
  72.  
  73.  
  74. MAGEE ENTERPRISES, INC.
  75. POST OFFICE BOX 1587
  76. NORCROSS, GEORGIA 30091  USA
  77.  
  78.  
  79. Sales:                  Monday - Friday
  80.       404-446-6611      Voice 9 AM - 5 PM Eastern Time
  81.       800-662-4330      Orders Only
  82.       404-368-0719      FAX (24 Hours/7 Days)
  83.  
  84.  
  85. Technical Support Group:      Monday - Friday
  86.  
  87.       404-662-5387      Voice 9 AM - 4 PM Eastern Time
  88.       404-446-6650      Big Peach BBS (24 Hours/7 Days)
  89.       76004,1541 or 
  90.       70167,2200        CompuServe (24 Hours/7 Days)
  91.  
  92.  
  93.  
  94. Documentation by Mark Strelecki, Swati Mahajan, Randal DePriest, and Marshall
  95. Magee. Artwork by Neisha L. Keith. Based on "Overview Too", an original work
  96. by James Mathews.
  97.  
  98.  
  99.  
  100.  
  101. This manual was developed using WordPerfect 5.0.
  102.  
  103.  
  104.  
  105.  
  106. May 1989 Release
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  120. TABLE OF CONTENTS
  121.  
  122. Section           Title
  123.  
  124.                   License Agreement 
  125.  
  126. 1                 Introduction
  127.  
  128. 1-1               Features of Treeview
  129. 1-2               Documentation Conventions
  130.  
  131. 2                 Installation
  132.  
  133. 2-1               System Requirements
  134. 2-2               Installing Treeview
  135.  
  136. 3                 Getting Started
  137.  
  138. 3-1               Command Line Parameters
  139. 3-2               Menu Bar
  140. 3-3               The Header Area
  141. 3-4               The File Name Area
  142. 3-5               The Status Line
  143. 3-6               The Help System
  144.  
  145. 4                 Important Keys Within Treeview
  146.  
  147. 4-1               Alternate Key Usage
  148. 4-2               Control Key Usage
  149. 4-3               Function Key Usage
  150. 4-4               The Escape Key
  151. 4-5               Other Important Keys
  152. 4-6               The Mouse
  153. 4-6.1             Mice - Generally Speaking
  154. 4-6.2             Executing Files With the Mouse
  155. 4-6.3             Tagging Files With the Mouse
  156. 4-6.4             Scrolling Around With the Mouse
  157. 4-6.5             Viewing Files With the Mouse
  158. 4-6.6             Dragging the Mouse
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  179. Section           Title
  180.  
  181. 5                 Elements of Treeview
  182.  
  183. 5-1               The Directory Tree      
  184. 5-1.1             File Masks
  185. 5-2               Extra File Information
  186. 5-2.1             File Sorting
  187. 5-3               File Selection Attributes
  188. 5-4               Find File Name
  189. 5-5               Show-All and Show-Sub Modes
  190. 5-6               Subdirectories
  191. 5-7               Terminate and Stay Resident Utilities
  192. 5-8               Update Target Directory
  193. 5-9               Window Commands
  194. 5-10              Interrupting Tagged File Operations
  195. 5-11              DOS Command Recall
  196. 5-12              External Functions of Treeview
  197. 5-13              File Oriented Operations
  198. 5-13.1            Copying Files
  199. 5-13.2            Renaming and Moving Files
  200. 5-13.3            Viewing Files
  201. 5-13.4            Editing Files
  202. 5-13.5            Resetting File Date and Time
  203. 5-14              Command Prototypes
  204. 5-15              Displaying and Resetting File Attributes
  205.  
  206. 6                 Customizing Treeview
  207.  
  208. 6-1               Screen Colors
  209. 6-2               DOS Command Macros
  210. 6-3               Setting File Limits
  211. 6-4               Point-and-Go
  212. 6-5               User Defined Keys
  213. 6-6               Using EMS Memory
  214. 6-7               Video Snow Checking
  215. 6-8               Defining the Editor and Viewer
  216. 6-9               DOS Volume Labels
  217. 6-10              DOS Verify
  218.  
  219. 7                 Shareware Considerations
  220.  
  221. 7-1               What is Shareware?
  222. 7-2               How to Register
  223.  
  224.  
  225. APPENDIX A        Treeview Menu Structure
  226.  
  227. APPENDIX B        Treeview Help Structure
  228.  
  229. APPENDIX C        Treeview Keystroke Commands
  230.  
  231. APPENDIX D        DOS Command Macros
  232.  
  233. APPENDIX E        Customer Support Information
  234.  
  235. APPENDIX F        Treeview and the Disk Operating System
  236.  
  237.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  238. LICENSE AGREEMENT
  239.  
  240. The Treeview(TM) product is NOT "Public Domain" and it is NOT "Freeware".
  241. Treeview is a copyrighted software product developed and owned by Magee
  242. Enterprises, Inc. located in Norcross, Georgia, U. S. A. Magee Enterprises,
  243. Inc. grants you without charge the right to reproduce, distribute and use
  244. copies of this version of our Treeview shareware software product, subject to
  245. the limitations specified below, and on the express condition that you do not
  246. receive any payment, commercial benefit, or other consideration for such
  247. reproduction or distribution, or change this license agreement or the
  248. following copyright notice which appears in the software, documentation, user
  249. interface, menus, and magnetic media: Copyright 1988, 1989 Magee Enterprises,
  250. Inc. All rights reserved worldwide.
  251.  
  252. Limitations: You may make and keep one (1)back-up copy of the software for
  253. your personal use, provided that (i) you copy all the copyright, trademark,
  254. and other information indicated on the initial screen display (or on the
  255. diskette label, for the registered version disk) onto your backup diskette
  256. label, and (ii) you have registered. Also you may distribute copies to other
  257. persons, but solely for their evaluation (i.e., to decide whether to continue
  258. using the product and therefore register) and solely for evaluation by such
  259. other persons during that thirty (30) day period. Treeview must NOT be sold or
  260. otherwise provided as part of a larger system, or as a part of a more
  261. inclusive product or service, without express written consent and licensing
  262. from Magee Enterprises, Inc.
  263.  
  264. The rights to receive any such financial or other benefit, and to modify the
  265. product or employ its components in any kind of derivative work, are reserved
  266. exclusively by Magee Enterprises, Inc. Support from users enables us to
  267. develop additional features and future versions of the Treeview product.
  268. Registered users benefit from enhanced technical support, notice of new
  269. products, and increased bulletin board access. Contact us at:
  270.  
  271. Magee Enterprises, Inc.
  272. Post Office Box 1587
  273. Norcross, Georgia 30091 USA
  274.  
  275.  
  276. Also, please feel free to contribute your ideas regarding desired additional
  277. product features and functionality.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  297. THIS PRODUCT IS LICENSED "AS IS" WITHOUT ANY WARRANTY OF MERCHANTABILITY OR
  298. FITNESS FOR A PARTICULAR PURPOSE, PERFORMANCE, OR OTHERWISE; ALL WARRANTIES
  299. ARE EXPRESSLY DISCLAIMED. BY USING THE TREEVIEW PRODUCT, YOU AGREE THAT
  300. NEITHER MAGEE ENTERPRISES, INC. NOR ANY OFFICERS, DIRECTORS, EMPLOYEES,
  301. SHAREHOLDERS, AFFILIATES, OWNERS, OR OTHER RELATED PARTIES WILL BE LIABLE TO
  302. YOU OR ANY THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE) OR PERFORMANCE OF
  303. THIS PRODUCT, OR FOR ANY DAMAGES WHATSOEVER WHETHER BASED ON CONTRACT, TORT OR
  304. OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH POSSIBILITY IN ADVANCE. (SOME
  305. STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL
  306. DAMAGES, SO THE FOREGOING LIMITATION MAY NOT APPLY TO YOU.)
  307.  
  308. You may not reverse-engineer, disassemble, modify, decompile, or create
  309. derivative works of the product. You acknowledge that the product includes
  310. certain trade secrets and confidential information, all of which is the
  311. copyrighted intellectual property of Magee Enterprises, Inc. Treeview is a
  312. trademark of Magee Enterprises Inc. and the Magee Enterprises logo is a
  313. trademark of Magee Enterprises, Inc. All rights are reserved worldwide. IBM,
  314. PS/2 and Personal System/2 are registered trademarks of IBM Corporation.
  315.  
  316. Restricted Rights Legend
  317.  
  318. Use, duplication, or disclosure by the Government is subject to restrictions
  319. as set forth in sub paragraph (c) (1) (ii) of the Rights in Technical Data and
  320. Computer Software clause of DFARS 252.227-7013. Magee Enterprises, Inc., Post
  321. Office Box 1587, Norcross, Georgia 30091 USA.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  356. SECTION 1
  357. THIS IS TREEVIEW(TM)
  358.  
  359. Thank you for your interest in Treeview(TM). Treeview is a hard disk and file
  360. management utility for IBM(TM) Personal Computers, Personal System/2(TM), and
  361. other PC compatible computers.
  362.  
  363. Treeview is a powerful hard disk and file management system. It gives you the
  364. ability to execute DOS commands, but it does not pretend to be a full featured
  365. DOS shell that simplifies (and sometimes hinders) all DOS functions. Treeview
  366. is NOT a memory resident program that can be called up via "hot" keys. Both of
  367. these constraints were designed into Treeview to keep it as direct and
  368. unencumbering as possible.
  369.  
  370. Treeview gives you simple, straightforward commands to accomplish everyday
  371. operations such as copying, renaming, erasing and backing up files, and much
  372. more. Treeview removes the guesswork from file management tasks by displaying
  373. the files on your disk in a tabular format that is continually updated in
  374. response to your commands. Treeview speeds up time consuming disk cleanup and
  375. maintenance sessions.
  376.  
  377. You'll find that Treeview is most useful on computer systems that have a hard
  378. disk for data storage. Treeview works just fine on floppy disk based systems,
  379. but the file maintenance needs of floppy-only systems are not as great as hard
  380. disk systems. Few people have multiple directories and hundreds or thousands
  381. of files on floppy-only systems.
  382.  
  383. This document describes the installation and usage of Treeview. It also
  384. describes many features and functions of the program. Once you begin using
  385. Treeview, you'll discover more about how it works from the on-line help
  386. facility and by experimenting with the various commands.
  387.  
  388. 1-1 Features of Treeview
  389.  
  390. In addition to the standard file and disk maintenance functions (copy, rename,
  391. erase, etc.), Treeview has many other useful features including:
  392.  
  393. *     Supports from 1 to 6 windows allowing as many as 6 disks (or            
  394.       directories) to be displayed on screen at the same time
  395.  
  396. *     A directory tree display that shows your disk's directory structure in  
  397.       an easy-to-understand graphical layout
  398.  
  399. *     A powerful "Show-All" and "Show-Sub" function that allows all files     
  400.       on the current disk or under the current directory to be displayed and  
  401.       accessed as if they were all in one subdirectory
  402.  
  403. *     A "Find File" function permits you to find any file on any disk in      
  404.       seconds
  405.  
  406. *     A file viewing function that displays files as ASCII text or in hexa-   
  407.       decimal format, and permits the use of any listing or editing program   
  408.       at the user's option
  409.  
  410. *     A full screen windowed interface with user selectable colors and        
  411.       defaults
  412.  
  413.  
  414.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  415. *     Extensive on-line, menu-driven help available at any time with one      
  416.       keystroke
  417.  
  418. *     DOS Command Macros that give the user the ability to access complete    
  419.       file and pathnames with just one or two characters and perform          
  420.       multiple DOS commands on a series of tagged files
  421.  
  422. *     Automatic recall of previously entered DOS commands
  423.  
  424. *     Full mouse support, network compatible
  425.  
  426. *     EGA/VGA video support for 25/43/50 line modes
  427.  
  428. *     Easily modify these file attributes: Hidden, Read-Only, System or       
  429.       Archive
  430.  
  431. *     Easily alter file time/date stamp, disk volume label, and verify status
  432.  
  433. *     Update file directories quickly and easily
  434.  
  435. *     Runs under DOS 2.X, 3.X, or 4.X
  436.  
  437. 1-2 Documentation Conventions
  438.  
  439. Throughout this document, references to Treeview menu selections are
  440. surrounded by brackets ([ ]) and some have vertical bars (|) separating
  441. entries from different menus. For example,
  442.  
  443. [Other | Setup Parameters | Screen Colors]
  444.  
  445. represents selecting the "Other" entry from the top level menu, the "Setup
  446. Parameters" entry from the Other submenu, and the "Screen Colors" entry from
  447. the Setup Parameters submenu.
  448.  
  449.                               WARNING! 
  450.  
  451. Due to the nature of some of the commands available under DOS version 3.3 and
  452. higher, we recommend that you DO NOT USE Treeview within a system where
  453. APPEND, SUBST or JOIN commands are in effect. These commands can create
  454. confusion for Treeview when copying, moving or renaming files, and the best
  455. procedure is simply not to use them. Please consult your DOS manual for
  456. further explanation regarding these commands and their use.
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  474. SECTION 2
  475. INSTALLATION
  476.  
  477. 2-1 System Requirements
  478.  
  479. Treeview requires an IBM PC, XT, AT, PS/2 or compatible computer with 256K RAM
  480. (or more) to work properly. In addition, version 2.0 or greater of PC-DOS or
  481. MS-DOS is required.
  482.  
  483. Treeview requires approximately 158K of computer memory to contain the
  484. program's executable code and common data. Additional memory is allocated as
  485. required to contain the file information for each open directory window and a
  486. copy buffer when copying files. The file information memory can either be
  487. allocated in conventional RAM or in EMS RAM if available on your system.
  488.  
  489. You can change Treeview's total memory requirements by changing the number of
  490. files allowed per directory window. The largest setting, 2515 files per
  491. window, requires 64K of additional memory (conventional or EMS) per window.
  492. The default value of 1000 files per window requires approximately 26K (32K if
  493. EMS) per window.
  494.  
  495. Since Treeview is NOT a Terminate and Stay Resident (TSR) program, the memory
  496. it uses is only required when you are actually running the program. The
  497. advantage to using EMS memory is to allow any programs executed from Treeview
  498. to use as much conventional DOS memory as possible for their own purposes.
  499.  
  500. To improve display speed, Treeview normally writes directly to the video
  501. screen memory of your computer. Treeview works well with the IBM Monochrome
  502. Display Adapter (MDA), Color Graphics Adapter (CGA), Enhanced Graphics Adapter
  503. (EGA), Video Graphics Array (VGA), and compatibles. Other video adapters that
  504. can emulate either the MDA or CGA should work properly.
  505.  
  506. Treeview is also "DESQview aware," meaning it can run in a small window under
  507. Quarterdeck Office Systems' DESQview(TM) multitasking program.
  508.  
  509. 2-2 Installing Treeview
  510.  
  511. Installing Treeview is a very simple process--there are only three files
  512. required to run the program. They are TV.EXE (the program itself), TV.HLP (the
  513. help file), and TV.CFG (the configuration file). Default values will be used
  514. if Treeview can't locate TV.CFG when it starts up. If you change any of the
  515. default aspects of Treeview operations and answer YES when prompted to "Save
  516. changes to Disk? y/N", a TV.CFG file will be created (or updated).
  517.  
  518. If your system has a DOS PATH command set up, simply copy these three files
  519. into one of the directories identified in the PATH command. If you have a hard
  520. disk system, but have not set up a PATH command, you should read about it in
  521. your DOS manual or get someone knowledgeable to help you set one up.
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  533. Copy the TV.CFG and TV.HLP files into a separate directory, and tell Treeview
  534. where they reside by setting the environment variable TVFILES to the name of
  535. the directory. This has an advantage over using a PATH directory, because only
  536. the single TVFILES directory needs to be searched when accessing the TV.CFG or
  537. TV.HLP files. The following command in the AUTOEXEC.BAT file informs Treeview
  538. to look for its files in the directory C:\TV:
  539.  
  540.                            SET TVFILES=C:\TV
  541.  
  542. When Treeview is started, it tries to find and read the TV.CFG configuration
  543. data file. This file contains the configuration options that you've defined
  544. (for example, the display colors, the User Defined Key values, and the
  545. Point-and-Go values, and more). If the "TVFILES=" environment variable is
  546. defined, Treeview expects to find the TV.CFG file there. 
  547.  
  548. If TVFILES isn't defined in the environment, Treeview looks in the current
  549. directory; if TV.CFG isn't found there, the directories specified by the PATH
  550. command are searched. In case the file still can't be located, a set of
  551. default parameters will be used.
  552.  
  553. Treeview must be able to locate the TV.HLP file when you ask for on-line help.
  554. If TVFILES is defined, Treeview looks for the TV.HLP file in that directory.
  555. If TVFILES isn't defined, Treeview looks in the current directory and then the
  556. directories specified by the PATH command. In the event  the help file still
  557. can't be located, you'll be asked to supply the location of TV.HLP.
  558.  
  559. For those who are running a system with only floppy disks, it's recommended
  560. that you copy TV.EXE, TV.CFG and TV.HLP to your system disk. The TV.HLP file
  561. is not accessed unless you actually request help, so it can be left off if you
  562. are short on disk space.
  563.  
  564.  
  565.  
  566.                                PLEASE NOTE!
  567.  
  568.  
  569. There may be important information on this release of Treeview that did not
  570. make it into this manual. Please check the READ.ME file on your distribution
  571. diskette for the most current data. Thank you!
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  592. SECTION 3
  593. GETTING STARTED
  594.  
  595. 3-1 Command Line Parameters
  596.  
  597. The usual way to start up Treeview is to simply type TV and press Enter at the
  598. DOS command prompt. However, the following optional parameters can be
  599. specified on the command line to modify Treeview's behavior during a given
  600. run. The typical command line syntax to execute Treeview is:
  601.  
  602.                      TV [parm] ... [parm] d:\subdir
  603.  
  604. where [parm] is as follows:
  605.  
  606. /C or -C          Instructs Treeview to only use conventional memory,
  607.                   even if LIM/EMS memory is available and the [Use EMS
  608.                   (if available)] option is enabled
  609.  
  610. /E or -E          Allows use of LIM/EMS memory even if [Use EMS (if
  611.                   available)] option is disabled
  612.  
  613. /F or -F          Do not perform video snow checking even if the
  614.                   [Video Snow Checking] option is set
  615.  
  616. /S or -S          Perform video snow checking even if the [Video Snow
  617.                   Checking] option is disabled
  618.  
  619. /M or -M          Indicates that the following parameter is a file name
  620.                   mask. See below for an example of a file name mask
  621.  
  622. /4 or -4          Uses EGA 43/VGA 50 line mode if available
  623.  
  624. /2 or -2          Uses "normal" 25 line mode even if default is different
  625.  
  626.  
  627. d:\subdir         Use this as the initial drive and subdirectory
  628.  
  629.  
  630. A file name mask to display specific file names can also be entered on the
  631. command line, but only after a /M parameter. Supplying a file name mask on the
  632. command line works just as if the mask was specified with the [Other |
  633. Selection Criteria | File Name Mask] command. For example, the command line:
  634.  
  635.                             TV /M   *.MDF
  636.  
  637. invokes Treeview and tells it to only display files that have an extension of
  638. .MDF.
  639.  
  640. The file name mask must follow the /M parameter on the command line.  Several
  641. parameters can be entered on the same command line. For example:
  642.  
  643.                       TV /S /C /M  *.COM   D:\BIN
  644.  
  645. starts Treeview with video snow checking enabled (/S), EMS usage disabled
  646. (/C), and only files with the extension .COM in the directory D:\BIN
  647. displayed.
  648.  
  649.  
  650.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  651. Refer to Section 6-6, USING EMS MEMORY, and Section 6-7, VIDEO SNOW CHECKING
  652. for more information on EMS memory and video snow checking.
  653.  
  654. You can access Treeview's on-line help system (any time Treeview is "Ready!"
  655. for input) by pressing the F1 function key.
  656.  
  657. There are four areas on the main file display - the menu bar, the header area,
  658. the file name area, and the status line. The contents and usage of the
  659. different screen areas are described below.
  660.  
  661. 3-2 The Menu Bar
  662.  
  663. The menu bar across the top line of the screen shows the top level functions
  664. which Treeview can perform. You select a function from the menu bar by
  665. pressing the key that is the first letter of the desired function. Depending
  666. on your computer's video equipment and your video attribute/color setup, the
  667. first letter of the menu bar choices may be displayed in a different color or
  668. otherwise highlighted to make them stand out visually.
  669.  
  670. In most cases, selecting a function from the menu bar results in a "pull-down"
  671. submenu being opened. Submenus are a set of choices that appear in a box under
  672. the corresponding top level option. You select a submenu entry by either
  673. pressing the letter that is highlighted in the submenu entry (not always the
  674. first letter), or by using the up and down arrow keys (or mouse) to highlight
  675. the desired entry and then pressing Enter (or clicking the mouse button). The
  676. ESC key can be used to exit a submenu without selecting any of the choices.
  677. Please refer to the APPENDIX A for a "map" of the keystrokes to navigate the
  678. commands available within Treeview's menu bar.
  679.  
  680. In addition to the menus, many of Treeview's most common functions can be
  681. performed by the function and control keys and Alt key combinations. Function,
  682. control, and Alt key usage is described in Section 4, Appendix A, and in
  683. Treeview's on-line help system. Here is an example of the menu bar and an open
  684. submenu (in this case, the Files submenu):
  685.  
  686. Dir   Files   Help   Other    Sort  Tag/Untag   Windows  Xecute  Quit
  687.     |       |-----------------------|
  688.     | Set File Attributes           |
  689.     | Copy File(s)                  |
  690.     | Set File Date/Time            |
  691.     | Edit File               Alt-F |
  692.     | Erase File(s)                 |
  693.     | Extra File Info         Alt-I |
  694.     | Rename/Move File(s)           |
  695.     | View File               Alt-V |
  696.     | Xecute File             Alt-X |
  697.     ---------------------------------
  698.  
  699. 3-3 The Header Area
  700.  
  701. The header area at the top of the screen contains information about the
  702. current disk drive, the current directory, and Treeview options. The header
  703. section entitled "Volume" displays the volume label of the current disk, the
  704. total storage capacity of the disk in bytes, and the size of the remaining
  705. free space on the disk, also in bytes. If the current disk does not have a
  706. volume label, the label area is blank.
  707.  
  708.  
  709.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  710. The header section entitled "Path" normally displays the complete pathname of
  711. the current disk drive and directory. In either the show-all or show-sub
  712. modes, the Path area displays the pathname of the current file.
  713.  
  714. The header section labeled "Files" displays the number of files listed in the
  715. file name area, the total space used by those files (in bytes), the number of
  716. files tagged for group operations, and the space used by those tagged files
  717. (in bytes).
  718.  
  719. The final header section, "Selection", displays the selection criteria (mask)
  720. used to pick which files are displayed in the file name area. If no mask is
  721. shown, it means that ALL files will be displayed. If *.MDF is the mask, only
  722. files with an MDF extension will be shown.
  723.  
  724. Following is an example of the header area:
  725.  
  726.  
  727. +--Volume-----|---Path---------------------------------------------------
  728. |  AUTOMENU   |   C:\COMM                                               |
  729. |-----------------------Files-------------------------------Selection---|
  730. |  21309440 TOTAL  |    SELECTED: 7 FILES       768 BYTES   MSK:        |
  731. |  11669504 FREE   |    TAGGED:   0 FILES         0 BYTES   ATR:N...A   |
  732. |__________________|____________________________________________________|
  733.  
  734.  
  735. 3-4 The File Name Area
  736.  
  737. The file name area usually displays a sorted list of the file names in the
  738. current directory. If there are more file names to be shown than will fit on
  739. the screen at one time, you can use the arrow keys or the PgUp, PgDn, Home,
  740. and End keys to display the other file names.
  741.  
  742. You can select the manner in which the files are sorted for display with the
  743. [Sort] command, and you can specify that they be sorted by Name, Extension,
  744. Date, Size, or Unsorted, in Ascending or Descending order. More details on
  745. using the [Sort] command are in Section 5 as well as Appendix A.
  746.  
  747. Many of the Treeview commands operate on the current file. The current file is
  748. identified by being the only highlighted name in the file name area. The four
  749. arrow keys and the PgUp, PgDn, Home, and End keys can be used to select a
  750. different current file. The highlighted bar over the file name is called the
  751. "current file pointer" or sometimes just the "file pointer".
  752.  
  753. The file name area can be split into multiple windows to display different
  754. disk drives and/or directories on the screen at the same time. Only one window
  755. is current at a time (also called the current window). The current window is
  756. defined as the window where the current file (pointer) is located.
  757.  
  758. 3-5 The Status Line
  759.  
  760. The status line appears along the bottom of your computer's screen. It is
  761. divided into three segments. The first segment tells you what Treeview is
  762. doing and when it is ready for your input. The second segment simply reminds
  763. you that you can press the F1 function key for on-line help. The third segment
  764. shows whether or not the DOS verify mode is set on or off. The following is an
  765. example of the file name area (with two file windows displayed) and the status
  766. line.
  767.  
  768.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  769. C:\   -----------------------------------------------------------------------
  770.                                                                             |
  771. AUTO\             BRATEMM.SYS       JDISK.SYS         QEXT.SYS              |
  772. AUTOMENU          DV\               LIB\              SRC\                  |
  773. BATCH\            DV.BAT            MOUSE.SYS         WRITE\                |
  774. BIN\              COMM\             FC\                                     |
  775. BRATDISK          COMMAND.COM       GRAPHIC\                                |
  776.                                                              (Window #1)    |
  777. C:\SRC\TV  -----------------------------------------------------------------| 
  778.                                                                             |
  779. CVTHLP.C          GRAPHIC.H         TVFMOVE.C         TVVBUF.C              |
  780. CVTHLP.EXE        KEYS.H            TVMOVE.FN         TVVIEW.BAK            |
  781. DATE.ASM          LOGO.ASM          TVFUN.BAK         TVVIEW.C              |
  782. DIALOG.C          LOGO.BAK          TVFUN.H                                 |
  783.                                                              (Window #2)    |
  784. ----------------------------------------------------------------------------|
  785. | Ready!    |      Press F1 for Help        |       Verify: OFF             |
  786. ----------------------------------------------------------------------------|
  787.                                                              (Status Line) 
  788.  
  789. 3-6 The Help System
  790.  
  791. Treeview has an extensive on-line help system available at the press of the
  792. "H" key. Help is broken up into six major areas:
  793.  
  794. Treeview Commands
  795.  
  796. Input (Keyboard and Mouse)
  797.  
  798. Treeview Menus
  799.  
  800. Program Parameters
  801.  
  802. Registering Treeview
  803.  
  804. Treeview Screens
  805.  
  806. Within the [Help | Commands] option, further help is available on these
  807. subjects: Directories, Files, Viewing and Executing files, and Sorting and
  808. Tagging files. Help is also given on customizing Treeview's screen colors,
  809. default settings, User Defined keys, "Point-and-Go" keys, video options and
  810. more. Please refer to Appendix B for a more detailed "map" of the entire
  811. Treeview help system.
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  828. SECTION 4
  829. IMPORTANT KEYS WITHIN TREEVIEW
  830.  
  831. The on-line Help facility should be used to supplement the information
  832. presented in this section. You can get help at most any time by hitting the F1
  833. key.
  834.  
  835. 4-1 ALT Key Usage
  836.  
  837. Treeview has a number of Alt-key combinations that are shortcuts to many of
  838. the most common functions. Entering one of the following Alt-key combinations
  839. executes the corresponding menu entry, without traveling through the menus.
  840. Menu entries that have Alt-key shortcuts will display the shortcut at the
  841. right edge of the menu line. Alt-key combinations are performed by pressing
  842. and holding down the ALTernate key while tapping the second key, then
  843. releasing the alternate key. For example, "Alt-A" means to hold the ALTernate
  844. key down and tap the "A" key, then release the Alt key. 
  845.  
  846. Some of these special key combinations available within Treeview are as
  847. follows:
  848.  
  849. Alt-A       Files       Set File Attributes     Current File
  850. Alt-B       Files       Set File Attributes     Tagged Files
  851.  
  852. Alt-C       Files       Copy file(s)            Current File
  853. Alt-K       Files       Copy file(s)            Tagged Files
  854.  
  855. Alt-F       Files       Edit File
  856.  
  857. Alt-E       Files       Erase file(s)           Current File
  858. Alt-Y       Files       Erase file(s)           Tagged Files
  859.  
  860. Alt-R       Files       Rename/Move File(s)     Current File
  861. Alt-M       Files       Rename/Move File(s)     Tagged Files
  862.  
  863. Alt-I       Files       Extra File Information
  864. Alt-V       Files       View File
  865.  
  866. Alt-G       Dir         Login New Drive
  867. Alt-L       Dir         Login New Directory
  868. Alt-N       Dir         Reread Current Directory
  869. Alt-T       Dir         Show Dir Tree
  870.  
  871. Alt-S       Other       Setup Parameters
  872. Alt-P       Other       Setup Parameters        Point and Go Setup
  873.  
  874. Alt-U       Other       Setup Parameters        User Defined Keys
  875.  
  876. Alt-D       Xecute      DOS Command
  877. Alt-X       Xecute      Current File
  878. Alt-Q       Quit
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  887. 4-2 Control Key Usage
  888.  
  889. Treeview allows several Control-key combinations to be used in addition to the
  890. arrow and keypad keys. The Control-keys add a WordStar(TM)-like interface to
  891. Treeview. The sequence ^R means to hold down the Control key and
  892. simultaneously press the 'R' key, then release the Control key.
  893.  
  894. ^R  -       Same as PgUp                        ^G     -    Same as Del
  895. ^C  -       Same as PgDn                        ^V     -    Same as Ins
  896.                                                 ^H     -    Same as backspace
  897. ^W, ^E -    Same as up arrow                    ^M     -    Same as Enter
  898. ^Z, ^X -    Same as down arrow
  899.                                                 ^T     -    Tag/untag current
  900. ^A, ^S -    Same as left arrow                              file
  901. ^D, ^F -    Same as right arrow
  902.  
  903. 4-3 Function Key Usage
  904.  
  905. Treeview uses the function keys on the keyboard to execute several common
  906. functions with a single key. The function key usage is:
  907.  
  908. F1  -       Get Help
  909. F2  -       Tag/Untag the current file (toggles current tag state)
  910.  
  911. F3  -       Login to the parent directory
  912. F4  -       Login to the subdirectory under the file pointer (same as ENTER)
  913.  
  914. F5  -       Goto the next tagged file (next find in VIEW)
  915. F6  -       Goto the previous tagged file (prev find in VIEW)
  916.  
  917. F7  -       Open another file name display window
  918. F8  -       Close the current file name display window
  919.  
  920. F9  -       Goto the next file name display window
  921. F10 -       Goto the previous file name display window
  922.  
  923. The Alt-Fn, Shift-Fn and Ctrl-Fn (function key) combinations are called User
  924. Defined Keys and are described in Section 6-5.
  925.  
  926. 4-4 The ESC Key
  927.  
  928. The ESCape key quits or aborts whatever operation Treeview is currently
  929. performing. The exact effect of pressing ESC depends on the operation being
  930. performed.
  931.  
  932. At the highest level, the Escape key returns to the normal file name display
  933. from viewing a file, viewing the directory tree, setting color selections, and
  934. the on-line help facility.
  935.  
  936. Many of Treeview's submenus do not have a selection to quit or exit without
  937. performing a function. The Escape key does this by closing the last opened
  938. submenu. When multiple submenus are open, they can be closed in reverse order
  939. by pressing the Escape key once for each submenu. The Escape key also escapes
  940. from most pop-up window prompts. For example, selecting the [Dir | Login New
  941. Directory] command pops up a window asking which directory to log in. If you
  942. decide not to switch to another directory, just press the Escape key and the
  943. window will disappear.
  944.  
  945.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  946. 4-5 Other Important Keys
  947.  
  948. While Treeview's file windows are displayed, you may press the grey "plus" key
  949. to tag files or the grey "minus" key to untag files. These keys are
  950. functionally the same as the F2 function key and can be used to tag files the
  951. same way.
  952.  
  953. When using the grey plus and minus keys [+ -], you will notice that after
  954. tagging or untagging a file, the highlight bar moves down to the next filename
  955. in the display window. If you have your files sorted in the proper order, you
  956. will be able to mark an entire block of filenames simply by repeatedly
  957. depressing the grey plus key. Please note that the F2 key works in the same
  958. way - after you press it, the highlight bar will move down one file.
  959.  
  960. The equals key [=] is also very important in Treeview. Whenever you press the
  961. equals key, followed by a letter or number, Treeview will immediately move the
  962. highlight bar to the first occurrence of a filename that matches that letter
  963. or number. You can use this feature to rapidly locate a file anywhere on the
  964. disk. More details on the "find file" feature of Treeview can be found in
  965. Section 5-4.
  966.  
  967. Pressing the asterisk key [*] will access the user's prior menu selection. If
  968. no selection was previously made, the first (Directories) menu will drop down.
  969.  
  970. 4-6 The Mouse
  971.  
  972. This section deals with the mouse capabilities built into Treeview. You must
  973. make certain that you have enabled mouse support in Treeview. This is done
  974. from the [Other | Setup Parameters | Other Options | Mouse Support] menu.
  975. After selecting mouse support, save your changes to disk when prompted, then
  976. quit Treeview and restart it. Your mouse will now function throughout
  977. Treeview.
  978.  
  979. 4-6.1 Mice - Generally Speaking
  980.  
  981. Throughout Treeview, the left mouse button selects an operation, the right
  982. mouse button untags files and escapes out of menus, and pressing both mouse
  983. buttons at once tags files.
  984.  
  985. 4-6.2 Executing Files With the Mouse
  986.  
  987. While the main file window is shown on the screen, the mouse can select a file
  988. by pressing the left button while highlighting it. A rapid double-click of the
  989. left mouse button will attempt to execute the highlighted file (same as
  990. Alt-X). If the file does not have an extension of .COM, .EXE, or .BAT,
  991. Treeview will check to see if a Point-and-Go key has been set up and attempt
  992. to perform that action on the file. If none of these are true, the file will
  993. be viewed.
  994.  
  995. While looking at the directory tree, a single click of the left mouse button
  996. will move the highlight bar to that directory. A rapid double-click on that
  997. entry will log in to that directory (same as using the cursor keys to
  998. highlight a directory and then pressing enter to log into it).
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1005. When multiple file windows are open, clicking the left mouse button on any
  1006. file in a window will make that window the current one and also highlight the
  1007. file.
  1008.  
  1009. 4-6.3 Tagging Files With the Mouse
  1010.  
  1011. To tag a file, point at the desired file and press both mouse buttons. To
  1012. untag a file, point to it and press the right mouse button. When the file has
  1013. been tagged, an arrow will appear to the left of the filename.
  1014.  
  1015. 4-6.4 Scrolling Around With the Mouse
  1016.  
  1017. In each open file window, you will notice a set of four arrows and the words
  1018. "Root" and "Parent" in the upper right corner. These items are also displayed
  1019. when looking at the directory tree screen. Clicking the left mouse button on
  1020. one of these arrows will move the file or directory pointer in the indicated
  1021. direction, similar to pressing the corresponding cursor control key.
  1022.  
  1023. By pointing at the word "Parent" with the mouse and clicking on it, you will
  1024. move up the subdirectory structure one level, similar to pressing the F3 key.
  1025. If you click on the word "Root", you will log into the root directory of the
  1026. current drive.
  1027.  
  1028. 4-6.5 Viewing Files With the Mouse
  1029.  
  1030. While viewing a file, the left mouse button can be used to select any of the
  1031. commands on the menu bar. The Up and Down, Left and Right commands are
  1032. implemented by pointing at them and pressing the left mouse button.
  1033.  
  1034. If you have defined your own choice of file viewing programs, this mouse
  1035. support may not be the same, so check your listing program's documentation for
  1036. mouse support.
  1037.  
  1038. 4-6.6 Dragging the Mouse
  1039.  
  1040. Another concept of the mouse is called "dragging", and it is usually done by
  1041. holding down one or both mouse buttons while moving the mouse. In Treeview,
  1042. you can select a series of files from a window simply by holding down both
  1043. mouse buttons while moving your mouse over the files to be tagged.
  1044.  
  1045. Using a mouse with Treeview is not mandatory, but it can simplify moving
  1046. around and selecting files to operate on. A mouse is a more "friendly" way of
  1047. dealing with the drop down menus and pop-up windows that Treeview provides,
  1048. and while there is a keyboard equivalent to almost all mouse operations, we
  1049. feel that using a mouse can definitely help the learning curve of this
  1050. program. We recommend the use of a Microsoft mouse-compatible device because
  1051. it is fully supported by Treeview.
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1064. SECTION 5
  1065. ELEMENTS OF TREEVIEW
  1066.  
  1067. Treeview is a hard disk file management utility. Its strengths lie in the
  1068. ability to copy, move, rename and delete files, change file attributes, sort
  1069. filenames, and perform operations on one or more of these files.
  1070.  
  1071. Here in Section 5 we will discuss what Treeview is and exactly what it does.
  1072. First, we will discuss the most important feature of Treeview: the ability to
  1073. display a graphic directory "tree" of the files on your system.
  1074.  
  1075. 5-1 The Directory Tree
  1076.  
  1077. When the directory tree is displayed by Alt-T or the [Dir | Show Dir Tree]
  1078. command, a graphic tree somewhat like the following is shown:
  1079.  
  1080.             C:\
  1081.               +   AUTO  
  1082.               +   CATDISK
  1083.               +   COMM --------+    AQUARIUS
  1084.               |                +    MERCURY
  1085.               +   GRAPHIC -----+    DRAW
  1086.               |                +    PAINT
  1087.               +   INCLUDE -----+    SYS
  1088.               +   MAGEE -------+    AUTOMENU
  1089.               +   SRC ---------+    TV
  1090.               +   WRITE -------+    ARTICLES
  1091.                                +    WS
  1092.  
  1093. The tree represents the structure of the directories on the current disk
  1094. drive. Each column to the right indicates another subdirectory. The
  1095. directories described by the tree above are:
  1096.  
  1097.             C:\AUTO
  1098.             C:\CATDISK
  1099.             C:\COMM
  1100.                         C:\COMM\AQUARIUS
  1101.                         C:\COMM\MERCURY
  1102.             C:\GRAPHIC
  1103.                         C:\GRAPHIC\DRAW
  1104.                         C:\GRAPHIC\PAINT
  1105. ...and so on.
  1106.  
  1107. The current directory is shown under a highlighted bar (called the directory
  1108. pointer). You can switch to another directory by using the up, down, PgUp,
  1109. PgDn, right and left arrow keys to highlight the new directory. In addition,
  1110. the Home key moves to the top level or "root" directory and the End key moves
  1111. to the lowest rightmost directory. PgUp and PgDn will also move the pointer
  1112. quickly through a series of entries. Treeview does not actually switch (or
  1113. "login") to the new directory until you press the Enter key or select the
  1114. [Login] option from the directory tree menu bar.
  1115.  
  1116. As you move the directory pointer around the tree, the current directory
  1117. remains displayed in a different color/video attribute. This is the directory
  1118. to which Treeview returns if you press the Escape key or select the [Quit]
  1119. option from the directory tree menu bar, regardless of the directory pointer
  1120. location.
  1121.  
  1122.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1123. With the directory tree [Write] command, you can save the directory tree
  1124. information in a single disk file (named TV.DIR in the top level directory of
  1125. the current disk). When you bring up the directory tree display, Treeview
  1126. checks for this disk file--if it exists, the directory tree information is
  1127. read from the file instead of searching the disk for directories. This results
  1128. in a much faster tree display.
  1129.  
  1130. If you change your disk's directory structure outside of Treeview, you can
  1131. force a rescan of the entire disk for directories (instead of just reading the
  1132. TV.DIR file) by using the directory tree [New] command. This informs Treeview
  1133. of the changes you've made to directories since the last time the disk was
  1134. scanned.
  1135.  
  1136. The directory tree [Mkdir] command (similar to the DOS command of the same
  1137. name) "makes" a new subdirectory "under" the directory pointer. For example,
  1138. if you select the [Mkdir] command while the directory pointer is on the
  1139. directory C:\123\SALES, and you enter "JOURNAL" as the new subdirectory name, 
  1140. Treeview creates the directory C:\123\SALES\JOURNAL. New directories created
  1141. by [Mkdir] immediately appear in the graphic tree display.
  1142.  
  1143. The directory tree [Rmdir] command (also similar to the DOS command of the
  1144. same name) deletes or "removes" the subdirectory under the directory pointer.
  1145. Selecting [Rmdir] when the directory pointer was on the directory
  1146. D:\FORMS\LETTERS\SUPPORT will delete the SUPPORT directory, provided the
  1147. following conditions are met:
  1148.  
  1149. You can't delete the directory you're currently logged in to (the current
  1150. directory).
  1151.  
  1152. You can't delete the top level (root) directory of a disk.
  1153.  
  1154. You can't delete a directory that contains any files and/or other directories.
  1155. If you want to delete a directory that contains files, delete the files first
  1156. by using the [Files | Erase File(s)] command.
  1157.  
  1158. There are two directory tree options that are useful in conjunction with the
  1159. [Write] command. Both options are related to writing the directory tree file
  1160. to disk whenever changes are made in the disk's directory structure. Keeping
  1161. the file synchronized with the actual directory structure is important since
  1162. Treeview does not scan the disk for directories if the TV.DIR file exits
  1163. (unless you use the [New] command as noted above).
  1164.  
  1165. The first option, [Other | Setup Parameters | Directory Tree Options | Select
  1166. Drives to Always Write] allows you to specify a set of disk drives which are
  1167. to automatically have the TV.DIR file rewritten whenever you exit the
  1168. directory tree and there were directories created or deleted. A useful
  1169. application of this option is to specify all of your computer's hard disks.
  1170. The drives should be specified as single letters, with or without colons (:)
  1171. and spaces.
  1172.  
  1173. The second option, [Other | Setup Parameters | Directory Tree Options | Prompt
  1174. to Write when changes] will ask you if the TV.DIR file should be written when
  1175. changes have been made in the directory structure. This option is useful when
  1176. you may or may not want to write to the disk.
  1177.  
  1178.  
  1179.  
  1180.  
  1181.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1182. If neither option is specified, Treeview does not write the directory tree
  1183. file to disk unless you explicitly use the [Write] command to do so. If you
  1184. want Treeview to reread the current drive/subdirectory, use the [New] command
  1185. first, then the [Write] command to save the new information.
  1186.  
  1187. 5-1.1 File Masks
  1188.  
  1189. Normally, Treeview displays all files in the current directory whenever you
  1190. run it, however you also have the option of forcing Treeview to only show the
  1191. files you are interested in processing at the time. This is where the concept
  1192. of "file masks" comes in.
  1193.  
  1194. Think of a file mask as an easy way to "filter" the types of files that are
  1195. displayed. By default, Treeview will display files that match the mask of
  1196. "*.*". In other words, ALL FILES. If you set the file mask to "*.MDF" for
  1197. example, Treeview will only show files with an extension matching "*.MDF". A
  1198. File Mask of "TV.*" will only show files named "TV" with any extension. A File
  1199. Mask of "AUTO*.*" will show all files whose names start with the letters
  1200. "AUTO". The File Mask is a fast way to select the types of files Treeview will
  1201. display.  
  1202.  
  1203. Another way to control the files that are shown is to TAG the files you want
  1204. BY NAME. Then do another TAG operation and SELECT the files tagged. This
  1205. performs the same function as specifying a File Mask in that only certain
  1206. files in the current directory will be shown.
  1207.  
  1208. 5-2 Extra File Information
  1209.  
  1210. Treeview can display three levels of detail about files stored on a disk. The
  1211. level of detail displayed is changed with the Alt-I or [Files | Extra File
  1212. Info] command. Each time you select this option, Treeview will "toggle" to
  1213. another "level" of detail, from highest detail level to lowest. 
  1214. A default level of detail can be set with the [Other | Setup Parameters |
  1215. Startup Defaults | Extra File Info] options. The lowest level shows only file
  1216. names, and is illustrated below:
  1217.  
  1218. ANSI.SYS          COMMAND.COM       DRIVER.SYS
  1219. AUTOEXEC.BAT      CONFIG.NEW        DUET\
  1220. BATCH\            CONFIG.OLD        DV\
  1221.  
  1222. At the lowest level of detail, Treeview is able to show five columns of file
  1223. names per window. The second level displays full information on each file. In
  1224. addition to the file's name, its size, creation or last modification date and
  1225. time are shown. 
  1226.  
  1227. An example of the highest level of detail (full file information display) is
  1228. shown below:
  1229. ----------------------------------------------------------------------------
  1230. NAME              USED        ALLOC       DATE        TIME        R H S A
  1231. ----------------------------------------------------------------------------
  1232. ANSI.SYS          4963        6144        7/20/87     1:00:00pm   . . . .
  1233. AUTOEXEC.BAT      1135        2048        11/27/87    8:01:26pm   . . . .
  1234. BATCH\            <DIR>       <DIR>       11/21/87    5:31:55pm   . . . .DIR
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1241. Each file entry (except for directories) shows two file sizes, USED and
  1242. ALLOCATED. Due to the manner in which DOS stores files on disk, a file often
  1243. requires more space than it actually uses. The file size reported in the USED
  1244. column is the amount of useful data actually in the file. The size reported in
  1245. the ALLOCATED column is the amount of space allocated by DOS or reserved for
  1246. the file's use. The allocated (but unused) space is not available for other
  1247. files to use, and is a good indicator of those files which may be wasting
  1248. space. These files frequently include small batch files and text files.
  1249.  
  1250. A file's attributes are shown as a single character if the attribute is on, or
  1251. a period if the attribute is off (R - Read/Only, H - Hidden, S - System, and A
  1252. - Archive). The Directory attribute is shown by the characters DIR.
  1253.  
  1254. When full file information is being displayed, only one column of file names
  1255. can be shown per window.
  1256.  
  1257. The medium level of detail displays some, but not all, of the information per
  1258. file. The fields shown are: name, file size, and creation or modification date
  1259. and time. The allocated size and file attributes are not shown, thus allowing
  1260. two columns of file names to be shown per window. An example is shown below
  1261. (only one file per row will fit on the printed page):
  1262.  
  1263.  
  1264. ANSI.SYS          4963        7/20/87     1:00pm
  1265. AUTOEXEC.BAT      1209        3/25/89     1:45pm
  1266. BATCH\            <DIR>       2/14/88     11:03pm
  1267.  
  1268.  
  1269. 5-2.1 File Sorting
  1270.  
  1271. Treeview can sort the files for display in a variety of formats. The choices
  1272. you have for sorting files are as follows: by filename, extension, date, size,
  1273. or unsorted. You can also specify ascending or descending order. Please note
  1274. that when sorting files for display, no files are actually relocated, just
  1275. shown onscreen in the manner you have specified. The DOS directory is NOT
  1276. modified in any event.
  1277.  
  1278. From the Treeview main screen, you can sort the files in the current window by
  1279. typing the following keystrokes:
  1280.  
  1281.             S D  [Sort | by Date]  (sorts by date) or 
  1282.             S N  [Sort | by Extension]  (sorts by extension) or 
  1283.             S S  [Sort | by Size]  (sorts by size)
  1284.  
  1285. One of the benefits of sorting files is to logically group similar ones
  1286. together. When sorting by extension, all your batch files (.BAT) will be
  1287. listed together, all the program files (.EXE and .COM) and text files (.TXT
  1288. and .DOC, for example) will be grouped together, and so on. For example, this
  1289. would be a nice way to use Treeview if you needed to know about only a certain
  1290. type of file.
  1291.  
  1292. If you sort the files by size, the smallest files will be listed first, and
  1293. the largest will be listed last because this is considered ascending order. If
  1294. you tell Treeview to sort in descending sequence, the largest files would be
  1295. shown first, followed by successively smaller files.
  1296.  
  1297.  
  1298.  
  1299.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1300. Sorting the files by date will display the oldest files first, followed by
  1301. newer ones, again because this is ascending order. Unless otherwise selected,
  1302. ascending order is used by default when performing sorts within Treeview.
  1303.  
  1304. 5-3 File Selection Attributes
  1305.  
  1306. The File Selection Attributes function will allow you to work with a select
  1307. group of disk files, based on the DOS file attributes that the files
  1308. themselves have. Attributes are qualities that DOS maintains about each file
  1309. to tell it whether a particular file should or should not be displayed
  1310. (Hidden), used by the operating system (System), unchangeable (Read-Only), has
  1311. been copied (Archive), or is a directory entry (Directory). Check your DOS
  1312. manual for more information on file attributes.
  1313.  
  1314. The following attributes can be used for file selection:
  1315.  
  1316. Normal            Selects files which have none of the following
  1317.                   attributes set. This is not really a DOS file
  1318.                   attribute, but it's useful to treat it as one.
  1319.  
  1320. Archive           Selects files which have the Archive attribute
  1321.                   set. DOS sets the Archive attribute when a file
  1322.                   is created or modified.
  1323.  
  1324. Dir               Selects files which are subdirectories.
  1325.  
  1326. Hidden            Selects files which have the Hidden attribute set.
  1327.  
  1328. Read/Only         Selects files which have the Read/Only attribute
  1329.                   set.
  1330.  
  1331. System            Selects files which have the System attribute set.
  1332.  
  1333. As distributed, Treeview's default file selection attributes are N (Normal), R
  1334. (Read/Only), A (Archive), and D (Dir). This means that only files with the
  1335. Normal attribute (that is, no attributes at all), the Read/Only attribute, the
  1336. Archive attribute, or the Directory attribute will be displayed.
  1337.  
  1338. Selection attributes work by only displaying files that have one or more
  1339. matching attributes. A file which does not have any matching attributes is not
  1340. displayed. The current file selection attributes are shown in the header
  1341. "Selection" area. The displayed attributes are abbreviated to their first
  1342. letter.
  1343.  
  1344. There are two commands that set file selection attributes -  [Other |
  1345. Selection Criteria | by Attribute] and [Other | Setup Parameters | Startup
  1346. Defaults | Selection Attribs].
  1347.  
  1348. The [Other | Selection Criteria | by Attribute] command sets the selection
  1349. attributes for the current file name window. This command allows different
  1350. windows to be given different selection attributes, thereby displaying
  1351. different collections of files. When this command is used, Treeview rereads
  1352. the current window's directory (or directories if Show-All or Show-Sub mode is
  1353. active) and only displays those files which match the new attributes.
  1354.  
  1355.  
  1356.  
  1357.  
  1358.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1359. As an example, you can display all modified files on your disk (and only the
  1360. modified files) by using [Other | Selection Criteria | by Attribute] to turn
  1361. off all attributes except Archive. Then use [Dir | Show All Dirs] to read all
  1362. directories on the disk. Only the modified files (those with the Archive
  1363. attribute set) will be displayed.
  1364.  
  1365. The other selection attribute command, [Other | Setup Parameters | Startup
  1366. Defaults | Selection Attribs] sets Treeview's default selection attributes,
  1367. and are the initial values used every time you start the program. Treeview is
  1368. distributed with the Hidden and System attributes turned OFF since files with
  1369. these attributes are not typically manipulated by users. If you like to see
  1370. every file in any given directory, change the default attributes to include
  1371. Hidden and System files.
  1372.  
  1373. To change attributes of any file(s), please see Section 5-15.
  1374.  
  1375. 5-4 Find File Name
  1376.  
  1377. The Find File Name command moves the file pointer to the first file name in
  1378. the current window that matches the characters you specify. To search for
  1379. (find) a given file name in the current window, first press the equals [=]
  1380. key. Each character typed after the "=" key further defines the file name to
  1381. find. For example, typing "=T" moves the file pointer to the first file in the
  1382. window that starts with the letter "T". If you then type the letter "V", the
  1383. file pointer will move to the first file name starting with "TV".
  1384.  
  1385. If you type a character for which there is no matching file name, a beep will
  1386. sound and the file pointer will not move. You can change the name to search
  1387. for by using the Backspace key, all the way back to the "=" key. The status
  1388. line at the bottom of the screen contains the current file name search string
  1389. and brief instructions after typing "=".
  1390.  
  1391. The Find File Name command can be terminated by the ESC key and most other non
  1392. alpha-numeric keys and commands. The sequence
  1393.  
  1394.                                =TV [Ctrl-T] 
  1395.  
  1396. moves the file pointer to the first file name starting with TV and tags that
  1397. file.
  1398.  
  1399. It's important to realize that the Find File Name command does not search the
  1400. disk for a given file, it only searches the list of names in the CURRENT
  1401. DIRECTORY WINDOW. If the file name is not in the window, Find File Name will
  1402. not find it. To use this command to search for a specific file somewhere on
  1403. disk, use it in conjunction with the [Dir | Show All Dirs] command to search
  1404. all file names on the disk.
  1405.  
  1406. 5-5 Show-All and Show-Sub Modes
  1407.  
  1408. Normally Treeview displays the contents of a single directory in each file
  1409. name window. This mode of operation matches the way most people organize their
  1410. data on disk - related files are put together in the same directory. At times
  1411. however, it's more convenient to see all the files in a given set of
  1412. directories, or even all the files on a disk.
  1413.  
  1414.  
  1415.  
  1416.  
  1417.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1418. The [Dir | Show All Dirs] and [Dir | Show Sub Dirs] commands do just that.
  1419. [Show All Dirs] displays all files on the current disk (called Show-All mode)
  1420. and the [Show Sub Dirs] command displays all files in the current directory
  1421. and any directories under the current directory (called Show-Sub mode).
  1422.  
  1423. You may access this feature by typing the following:
  1424.  
  1425. D A  [Dir | Show All Dirs]  (to see ALL files on the disk) or
  1426. D S  [ Dir | Show Subdirs]  (files in the current directory and below)
  1427.  
  1428. This is a "toggle" switch, meaning that the first time the D A command is
  1429. used, all files will be displayed in the window. If you issue a second D A
  1430. command, only the files in the current subdirectory will be shown.
  1431.  
  1432. The Path section of the header displays the directory name of the current file
  1433. so that you can tell which directory a given file resides in when the Show-All
  1434. or Show-Sub mode is active. As you move the file pointer through the displayed
  1435. file names, the Path changes to show the location of the current file.
  1436. Normally, all file names displayed in a window would be in the same directory,
  1437. so the Path section would not change from file to file.
  1438.  
  1439. Selecting [Dir | Show All Dirs] or [Dir | Show Sub Dirs] a second time turns
  1440. off the corresponding mode and restores the display of the files in the
  1441. current directory.
  1442.  
  1443. You can use these commands in conjunction with the selection mask and/or
  1444. selection attributes to limit the files displayed. For example, a selection
  1445. mask of *.EXE combined with [Show All Dirs] displays all .EXE files on the
  1446. current disk.
  1447.  
  1448. Show-All and Show-Sub modes are just two of Treeview's most powerful features.
  1449. In these modes, you can work with all the files on any disk (or in a given
  1450. directory tree) just as easily as you could with the files in any single
  1451. subdirectory.
  1452.  
  1453. Some examples of Show-All/Show-Sub uses are:
  1454.  
  1455. 1) Erase all the .BAK files on drive C.
  1456.  
  1457. - Select all files on drive C [Dir | Show All Dirs].
  1458. - Tag all files with the extension .BAK [Tag/Untag | by Name].
  1459. - Erase all tagged files [Files | Erase File(s) | Tagged Files
  1460.   or Alt-Y].
  1461.  
  1462. Keystrokes used to perform this operation would be:
  1463.  
  1464.                    D  A  T  N    *.BAK(enter)  F  E  T  Y
  1465.  
  1466. (Directory Show-All, Tag by Name all ".BAK" files, File Erase Tagged YES)
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1477. 2) Turn off the Archive attribute of selected files so the DOS
  1478.    BACKUP program will not copy them to disk.
  1479.  
  1480. - Select all files                  [Dir | Show All Dirs].
  1481. - Tag all modified files            [Tag/Untag | Modified].
  1482. - Display only the tagged files     [Tag/Untag | Select Tagged].
  1483. - Untag (F2 key) the files which are to be backed up - leaving
  1484.   only modified files not to backed up still tagged.
  1485. - Turn off the Archive attribute of the tagged files [Files |
  1486.   Set File Attributes | Tagged Files or Alt-B].
  1487.  
  1488.  
  1489. 5-6 Subdirectories
  1490.  
  1491. DOS allows subdirectories to be given names just like any other type of file.
  1492. When looking at a list of file names, it's easy to forget which names
  1493. represent files and which names are actually subdirectories. To make the
  1494. distinction clear, Treeview displays directory names with a backslash
  1495. character (\) following the name. The following list shows several file and
  1496. directory names as they would be displayed by Treeview:
  1497.  
  1498. ANSI.SYS      COMMAND.COM           DRIVER.SYS              JDISK        
  1499. AUTOMENU\     CONFIG.SYS            DUET\                   LIB\         
  1500. BATCH\        CONFIG.OLD            DV\                     NOTES         
  1501.  
  1502. In addition to the [Dir | Login New Drive] and [Dir | Login New Directory]
  1503. commands, the F3 and F4 function keys can also be used to change directories.
  1504. The F3 key will login to the parent of the current directory, up to the top
  1505. level root directory on the current disk. The F4 key will login to the
  1506. subdirectory under the file pointer.
  1507.  
  1508. 5-7 Terminate and Stay Resident Utilities and Treeview
  1509.  
  1510. Terminate and Stay Resident (TSR) programs load into memory and remain there
  1511. when executed. You should avoid loading TSR routines from Treeview since the
  1512. TSRs would be placed above Treeview in memory. When you exit Treeview, an
  1513. unused "hole" would be left in memory where Treeview used to reside. This hole
  1514. in the computer's memory would generally cut down on the amount of memory
  1515. available to other programs executed after quitting Treeview. This is true not
  1516. only of Treeview, but of many other programs that also give you access to DOS.
  1517.  
  1518. One common DOS command, the PRINT command, is a TSR utility that remains in
  1519. memory after being loaded the first time. If you're going to use the PRINT
  1520. command from within Treeview, make sure that PRINT is used at least once
  1521. before starting Treeview. The following command could be added to your
  1522. AUTOEXEC.BAT startup file to load the resident portion of the PRINT command
  1523. whenever the computer is turned on or restarted.
  1524.  
  1525.                           PRINT /D:PRN >NUL:
  1526.  
  1527. The ">NUL:" on the command line simply keeps a couple of messages from the
  1528. PRINT program from appearing on the screen. This command should work in most
  1529. DOS versions. Refer to your DOS manual for more information on the PRINT /D
  1530. command option.
  1531.  
  1532.  
  1533.  
  1534.  
  1535.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1536. 5-8 Update Target Directory
  1537.  
  1538. When maintaining backup copies of files, or working with the same set of files
  1539. on multiple computers, it's often necessary to update your files so that all
  1540. copies of the same file are indeed the same version. Programmers (or anyone)
  1541. who use multiple subdirectories for source files will appreciate the ease of
  1542. updating files in their choice of target directory.
  1543.  
  1544. Treeview's [Dir | Update Target Directory] command provides a convenient way
  1545. to synchronize the files in different directories or disk drives. Two
  1546. directories are used by the [Update Target Directory] command - the source and
  1547. the target. Treeview selectively copies files from the source to the target,
  1548. so that the target directory contains the same files as the source.
  1549.  
  1550. What makes this command more convenient than a simple copy is that it only
  1551. copies the files in the source directory that were created or modified more
  1552. recently than the corresponding files in the target directory.
  1553.  
  1554. The source directory is always the current directory when the [Update Target
  1555. Directory] command is executed. Treeview prompts you to enter the name of the
  1556. target directory before copying any files. If you have opened a window into
  1557. the target directory, just pressing the PgUp or PgDn keys will automatically
  1558. fill in the information needed for the update.
  1559.  
  1560. The [Dir | Update existing files only] option modifies the behavior of the
  1561. [Update Target Directory] command. When this option is off, all files in the
  1562. source directory are checked against the target, and are copied if they are
  1563. more recent or if they don't exist in the target directory. When the [Update
  1564. existing files only] option is on, only files already in the target directory
  1565. will be updated, providing they are more recent versions. Files in the source
  1566. directory but not in the target will NOT be copied if this option is turned
  1567. on. Please note: Because Treeview uses the creation/modification date and
  1568. timestamp to determine if the files are the same or not, it's important that
  1569. your computer's date and time be accurately set for this command to work
  1570. properly. If your system doesn't have a real time clock, make sure the date
  1571. and time are set correctly whenever the computer is turned on or rebooted.
  1572.  
  1573. 5-9 Window Commands
  1574.  
  1575. Treeview can display from 1 to 6 file windows on the screen at a time. Each
  1576. window is independent of the others and can display the same or a different
  1577. drive and/or directory. File name windows are opened, closed, and switched
  1578. with the [Windows] command. When you start Treeview, it initially has one file
  1579. name window open, displaying the contents of the current directory. As you
  1580. open and close additional windows with the [Windows | Open] and [Windows |
  1581. Close] commands, the size of the windows will be adjusted so that all open
  1582. windows have an equal amount of screen space. The F7 and F8 keys are
  1583. short-cuts for opening and closing windows, respectively.
  1584.  
  1585. Only one of the open windows can contain the file pointer at a time; this is
  1586. called the current window. The Path, Files, and Selection sections of the
  1587. header area at the top of the screen always display information about the
  1588. current window. As you move the file pointer from window to window with the
  1589. [Window | Next] and [Window | Prev] commands, the header area updates to
  1590. reflect the current window status. The F9 and F10 keys are short-cuts for
  1591. moving to the next or previous window, respectively.
  1592.  
  1593.  
  1594.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1595. A newly opened file name window displays the same directory as the current
  1596. window, and it also inherits the current window's sort options, tagged files,
  1597. and selection criteria. If you want the new window to display a different
  1598. directory or disk drive, use the [Dir | Login New Directory] or [Dir | Login
  1599. New Drive] command to switch to the desired directory or drive.
  1600.  
  1601. Commands that operate on files only effect the directory shown in the current
  1602. window. For example, when you erase all tagged files with the [Files | Erase
  1603. File(s) | Tagged Files] command, only the tagged files in the current window's
  1604. directory are erased. [Erase File(s)] does not effect any tagged files in
  1605. other directories.
  1606.  
  1607. To close a file name window, just place the file pointer in the window to be
  1608. closed and press F8 or W C [Window | Close]. Closing a file name window
  1609. removes the window from the screen display. It has no effect on the files
  1610. themselves, it simply removes the window from the screen.
  1611.  
  1612. Windows are very useful when working with two or more directories or drives at
  1613. the same time (for example, when copying a set of files from a hard disk to a
  1614. floppy, or when moving files from one directory to another).
  1615.  
  1616. 5-10 Interrupting Tagged File Operations
  1617.  
  1618. When performing an operation on all tagged files (copy tagged, rename tagged,
  1619. erase tagged, etc.), the ESC, Ctrl-U, Ctrl-C, or Ctrl-Break keys can be used
  1620. to interrupt the process. Striking one of these keys during a tagged file
  1621. operation causes the message "Interrupt?" to be displayed. Respond Y to stop
  1622. the operation, N to continue.
  1623.  
  1624. Interrupting a tagged file operation does not restore files that have already
  1625. been processed, but it can keep further files from being modified. If another
  1626. DOS command is named in the operation, Treeview will attempt to continue
  1627. processing with that command, so the following note is placed here to suggest
  1628. otherwise.
  1629.  
  1630. WARNING: We recommend that you do NOT interrupt tagged file operations that
  1631. involve more than one DOS command (i.e., COPY $T $T.BAK^DEL $T^ECHO ALL DONE).
  1632. Treeview may continue processing files with the following command if there are
  1633. more than one in the prototype. Please check Section 6-2 for more on DOS
  1634. Command Macros.
  1635.  
  1636. 5-11 DOS Command Recall
  1637.  
  1638. When you are prompted for a response in a pop-up window (for example, when
  1639. logging in to a new directory or when entering a DOS command to execute), the
  1640. response can be edited with the Home, End, Ins, Del, backspace, left arrow,
  1641. and right arrow keys up until the time you press the Enter key to end the
  1642. input.
  1643.  
  1644. The Home and End keys move the cursor to the left and right ends of the
  1645. response, respectively. The Ins key turns the insert mode on and off, allowing
  1646. existing data to be typed over (when off) or new data to be inserted (when
  1647. on). The cursor is made larger when the insert mode is turned on. The Del key
  1648. deletes the character at the cursor position, while the backspace key deletes
  1649. the character just to the left of the cursor. The left and right arrow keys
  1650. simply move the cursor in the corresponding direction.
  1651.  
  1652.  
  1653.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1654. The up and down arrow keys can also be used when entering a response. Treeview
  1655. keeps track of the last 10 responses entered, and recalls the next oldest
  1656. response each time the up arrow key is pressed. The recalled response can be
  1657. edited or accepted (by pressing Enter) just as if it had been typed in again.
  1658. If you go past the response you wanted with the up arrow key, the down arrow
  1659. can be used to recall the more recent responses.
  1660.  
  1661. Finally, the PgUp and PgDn keys also effect the entry and editing of
  1662. responses. Pressing the PgUp or PgDn key when entering a response inserts the
  1663. name of the directory displayed in the file name window above or below the
  1664. current window, respectively. Each time the PgUp or PgDn key is pressed, the
  1665. next higher or next lower window's directory name is inserted. This is useful
  1666. when performing operations such as copying files or logging in to another
  1667. directory.
  1668.  
  1669. 5-12 External Functions of Treeview
  1670.  
  1671. Treeview can perform several "external" procedures - running any DOS program,
  1672. calling a user defined file editor or listing utility, and more. This ability
  1673. is usually referred to as a "shell", meaning that Treeview can provide an
  1674. alternate user interface to the computer instead of the standard DOS prompt
  1675. (C:>). 
  1676.  
  1677. By using a shell, users can normally be more productive with less
  1678. understanding of the commands available from the normal DOS prompt. A shell is
  1679. an environment that provides on-line help, colorful screen displays, easy
  1680. performance of repetitive tasks, and a common place of reference for the user.
  1681. A task is performed from the shell and then control is returned to the shell
  1682. program. In Treeview's case, this means that you can just point to a program
  1683. or executable file, hit the Enter key, X C, or Alt-X key [eXecute | Current
  1684. File] to run it. When the program is finished, you are returned to Treeview.
  1685.  
  1686. Treeview can be configured to either run its own internal file viewer or one
  1687. of your own selection. Similarly, you can set up an external editor to be
  1688. called with a single keystroke from within Treeview that will allow the user
  1689. to perform quick revisions to text files, batch procedures, or other ASCII
  1690. files.
  1691.  
  1692. Magee Enterprises, Inc. has another product that can be considered a "shell"
  1693. program, and it is called Automenu(R). Where Treeview is file oriented (point
  1694. at a file and perform an action on it), Automenu is application oriented
  1695. (point at an option on a menu and perform it). Both are examples of shell
  1696. programs because both allow you to perform complex tasks more easily with them
  1697. than without them. More details on the external functions of Treeview are
  1698. outlined in Appendix A.
  1699.  
  1700. 5-13 File Oriented Operations
  1701.  
  1702. With many of Treeview's file oriented operations, you must first tag (mark)
  1703. the files to be processed and then perform some type of command with those
  1704. tagged files. This is done by several means. You can move the highlight bar to
  1705. a file and then either press the grey "plus" key (on the numeric keypad) or
  1706. the F2 function key. This will mark the file as "tagged" and then proceed down
  1707. to the next filename that is displayed in the window.
  1708.  
  1709.  
  1710.  
  1711.  
  1712.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1713. You can also use the menu bar option at the top of the screen called
  1714. Tag/Untag. Do this by pressing the letter "T". You are given the option of
  1715. tagging files by name by specifying a file mask that fits the files you want
  1716. to process. You can specify "*.BAK" to tag all files with the extension .BAK,
  1717. or "STAR.*" to tag all files with the name STAR.
  1718.  
  1719. There are other options under the Tag/Untag function that will allow you to
  1720. select files by date and time, all files not already tagged, files with
  1721. today's date, and files with the archive attribute set (Modified). Check
  1722. Appendix A for the logic map on using the Tag/Untag menu option.
  1723.  
  1724. 5-13.1 Copying Files
  1725.  
  1726. After tagging the selected files you wish to copy, you will return to the main
  1727. display screen. From here you must press "F" to access the Files menu bar
  1728. option, and then "C" to copy files. You will be asked if you want to copy the
  1729. Current file or all Tagged files. Press "T" to copy a series of tagged files,
  1730. and then answer the prompt about the destination for the files to be copied
  1731. to.
  1732.  
  1733. When prompted for the destination, you can use the PgUp and PgDn keys to
  1734. access the names of the directories into which windows are currently open, or
  1735. you can point at the small letter "T" on the top of the destination window.
  1736. This will bring up a graphic directory tree that you can point to your
  1737. destination and double-click the mouse button. The same will happen if you use
  1738. the Alt-T command. 
  1739.  
  1740. To copy tagged files to another drive, just input the name of the drive to be
  1741. copied to (A:, etc.). If there is a special subdirectory that you wish the
  1742. files to be copied into, specify the subdirectory name when Treeview asks for
  1743. the destination (D:\FileDirectory, etc.). An easy way to copy files is to open
  1744. one window into the source directory and one into the target directory. Then
  1745. after tagging the files to be copied, give the F C T command, and when
  1746. prompted for the destination, press PgDn, then Return. Treeview will copy all
  1747. tagged files quickly and easily!
  1748.  
  1749. 5-13.2 Renaming and Moving Files
  1750.  
  1751. Treeview has a rather simple approach to moving files - it merely renames the
  1752. path associated with the filename so that DOS will keep track of it in another
  1753. subdirectory. Instead of making a copy in another subdirectory (with the
  1754. inherent space taken by duplicating files) and then deleting the original as
  1755. so many file products do, Treeview just renames the path specification to the
  1756. file you are renaming or moving. For example:
  1757.  
  1758. C:\AUTOMENU\MARSHALL.MDF
  1759.  
  1760. can be "moved" to another subdirectory by renaming it to
  1761.  
  1762. C:\BACKUP\MARSHALL.MDF  or  C:\PUBLIC\MARSHALL.MDF
  1763.  
  1764. There is no reason to duplicate the file when DOS will accept the renamed path
  1765. specification as part of the new filename. This effectively "moves" a file
  1766. LOGICALLY without moving it PHYSICALLY, and does not require additional space
  1767. be available on disk for the newly named file.
  1768.  
  1769.  
  1770.  
  1771.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1772. 5-13.3 Viewing Files
  1773.  
  1774. Treeview has a built-in file listing utility that will automatically switch
  1775. between ASCII and hexadecimal modes, depending on the format of the file you
  1776. wish to view. By just placing the highlight bar over a file and pressing Enter
  1777. you will see the contents of the file displayed on the screen. This is
  1778. important if you need to look at several files before deciding which one you
  1779. might wish to edit.
  1780.  
  1781. View any current file by pressing "F" for Files and then "V" for View. The
  1782. highlighted file will then be displayed on the screen. A shortcut would be to
  1783. highlight a file and then press Alt-V. If the current (highlighted) file is in
  1784. ASCII (text) format, it will be displayed in full screen format. If it is not
  1785. ASCII, it will be displayed in hex format - the left two thirds of the screen
  1786. will show the hexadecimal representation of each byte in the file, with the
  1787. printable equivalents shown on the right one third of the screen.
  1788.  
  1789. Treeview allows you to use either the native file lister included with the
  1790. product, or configure one of your own. Please refer to Section 6 for tips on
  1791. "Customizing Treeview" for details on configuring your own external functions.
  1792.  
  1793. 5-13.4 Editing Files
  1794.  
  1795. There is no editor built into Treeview, so this is what we call an "external"
  1796. function. It is something that you can set up, but will not operate if you do
  1797. not do so. From the main display you can press [Other | Setup Parameters |
  1798. External Program Hooks | File Editor] to access a screen that will ask you for
  1799. the "command prototype" of the editor you wish to use.
  1800.  
  1801. The command prototype is in the same form as those that will be discussed in
  1802. Section 5-14, and makes use of the DOS macros that are explained in Section
  1803. 6-2. Typically you would tell Treeview to use a command prototype that looks
  1804. like this:
  1805.  
  1806.                                EDITOR $F
  1807.  
  1808. where "EDITOR" is the command to start your choice of editing programs, and
  1809. "$F", a DOS macro which will be substituted by the full path and filename of
  1810. the current file. This will allow you to highlight a file from the main screen
  1811. and then press Alt-F ([Files | Edit File]) to start your editor and pass to it
  1812. the name of the highlighted file. 
  1813.  
  1814. Using the example above, if the highlight bar is placed over a file called
  1815. MYFILE.TXT on the C: drive in the \TEXT subdirectory, the command passed to
  1816. DOS would be
  1817.  
  1818.                        EDITOR C:\TEXT\MYFILE.TXT
  1819.  
  1820. 5-13.5 Resetting File Date and Time
  1821.  
  1822. The date and time attributes of any file(s) can be changed by using the [Files
  1823. | Set File Date/Time] command. Treeview will ask if you want to change the
  1824. current file or all tagged files, and then present a pop up window displaying
  1825. today's date and time. You can press the enter key to use this data, or input
  1826. your own data and then press enter. 
  1827.  
  1828.  
  1829.  
  1830.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1831. You can also use the up and down cursor keys to "recall" a previously entered
  1832. date or time, so if you are changing these attributes on many files, this
  1833. "automatic command recall" feature can save you quite a few keystrokes.
  1834.  
  1835. In any event, changing file dates and times can be a convenience for those who
  1836. must track files by their vintage, such as a software librarian or programmer.
  1837.  
  1838. 5-14 Command Prototypes
  1839.  
  1840. Treeview allows you to build your own series of DOS commands to be executed at
  1841. a variety of points in the program. There are User Defined Keys (UDK), DOS
  1842. Command Macros (DCM) and the Point-and-Go (P&G) commands, all of which are
  1843. made up of what are called "Command Prototypes".
  1844.  
  1845. A Command Prototype is nothing more than a string of characters that includes
  1846. one or more DOS commands and one or more Treeview macro characters ($T, $F,
  1847. etc.). To Treeview, this represents a "prototype" (working example) of the
  1848. command that you want carried out, and usually takes the following form:
  1849.  
  1850.             DOS_Command [TV_Macro]...^DOS_Command [TV_Macro]...
  1851.  
  1852. where DOS_Command is a valid program or instruction, and TV_Macro is one of
  1853. the Treeview macro characters as discussed in Section 6-2. This Command
  1854. Prototype is the instruction that tells Treeview what actions to take whenever
  1855. the user invokes the command. Here is an example of a Command Prototype:
  1856.  
  1857.       ECHO $T >> DIRS^PKZIP -A ZIPFILE @DIRS^DEL DIRS^ECHO DONE
  1858.  
  1859. This prototype has three parts, each separated by the "^" (caret) symbol. The
  1860. three parts break down as follows:
  1861.  
  1862. 1. ECHO $T >> DIRS
  1863.  
  1864. This instruction tells Treeview to ECHO (write) the name of every TAGGED file
  1865. ($T) to another (temporary) file called DIRS. This will create a file (DIRS)
  1866. with the names of all tagged files in it.
  1867.  
  1868. 2. PKZIP -A ZIPFILE @DIRS
  1869.  
  1870. This command calls Phil Katz's fine file compression utility program PKZIP and
  1871. instructs it to create a single compressed file called ZIPFILE and to place in
  1872. it all the files listed in the file DIRS. This means that you can tag a series
  1873. of files, press a User Defined Key and perform this operation on all the files
  1874. at the same time with a single keystroke.
  1875.  
  1876. 3. DEL DIRS
  1877.  
  1878. This will delete the temporary list file named DIRS, as it was only needed for
  1879. the execution of this particular prototype.
  1880.  
  1881. 4. ECHO DONE
  1882.  
  1883. This last directive will ECHO (write) a message on the screen to tell the user
  1884. that this operation is "DONE". Command Prototypes are used throughout
  1885. Treeview, and more discussion on this and related subjects will be found in
  1886. the next section.
  1887.  
  1888.  
  1889.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1890. 5-15 Displaying and Resetting File Attributes
  1891.  
  1892. Treeview can easily display and/or modify the attributes of any DOS file.
  1893. There are two ways to display the attribute of any file. First, you can elect
  1894. the most detail from the file window with the ALT-I command. This will show
  1895. you not only the file attributes, but also the file size and the last date it
  1896. was modified. The other way is to place the file pointer over the filename and
  1897. use the ALT-A command. This will bring up a window that will not only show you
  1898. the current attributes of the file, but also give you a chance to change them.
  1899.  
  1900. To change a single file's attributes, place the file pointer over the filename
  1901. and press ALT-A. Press the letter(s) of the attribute(s) to be changed, then
  1902. press C to write the change to disk. Treeview will then return to the main
  1903. file display and await your next command.
  1904.  
  1905. To change the attributes of multiple files, tag the files desired and then
  1906. press ALT-B. Press the letter(s) of the attribute(s) to be changed, then press
  1907. C to write the changes to disk. Treeview will then return to the main file
  1908. display and await your next command. Attributes that can be displayed and/or
  1909. modified with this version of Treeview are detailed in Section 5-3, File
  1910. Selection Attributes.
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  1949. SECTION 6
  1950. CUSTOMIZING TREEVIEW
  1951.  
  1952. 6-1 Screen Colors
  1953.  
  1954. The [Other | Setup Parameters | Screen Colors] command allows you to customize
  1955. the video attributes Treeview uses to display various types of information. On
  1956. a color display monitor, the video attributes determine which colors are
  1957. displayed. On a monochrome monitor, the attributes select display options such
  1958. as underlined, inverse video, and intensity.
  1959.  
  1960. You can specify video attributes for ten different types of displayed text.
  1961. They are: Normal text, Highlighted text, Window text, Highlighted window text,
  1962. Heading text, Background text, Tagged file name text, Menu text, Highlighted
  1963. menu text, and Selected menu text. The easiest way to determine the different
  1964. types of text is to change the colors and observe the results.
  1965.  
  1966. When you select the [Other | Setup Parameters | Screen Colors] command, the
  1967. display shows the types of text that can be selected, and the color
  1968. combinations allowed. The PgUp and PgDn keys on the numeric keypad select the
  1969. type of text to define, while the arrow keys select the particular display
  1970. attribute for that type of text. The current type of text and the current
  1971. attribute are always indicated by  >TEXT<  characters.
  1972.  
  1973. When changing video attributes, three choices are available from the menu bar
  1974. -  Accept, Reset, and Quit. Use the [Accept] option to save the color
  1975. combination you've selected. If you've selected a set of attributes you don't
  1976. like, you can use the [Quit] command to return to the previous attribute
  1977. settings. With the [Reset] command, you can restore the default (permanent)
  1978. settings even if you've accepted other attributes. [Reset] restores the last
  1979. settings that were written to the TV.CFG file.
  1980.  
  1981. 6-2 DOS Command Macros
  1982.  
  1983. A set of command "macros" are available for use wherever Treeview accepts
  1984. input of a DOS command ([Xecute | Current File], [Xecute | DOS Command], User
  1985. Defined Keys, and Point-and-Go commands). Before executing the DOS command,
  1986. Treeview replaces the macro with its value. The supported macros are:
  1987.  
  1988. $C    The current file name, with extension.
  1989. $D    The current drive letter, without a trailing colon (:).
  1990. $F    The full pathname of the current file, including drive,
  1991.       directory, and file name (with extension).
  1992. $P    The directory pathname for the current or tagged file,
  1993.       without a trailing backslash (unless the current directory
  1994.       is the root and a \ does not follow the $P macro).
  1995. $T    The first or next tagged file name, with extension.  When
  1996.       $T appears in a command line, Treeview executes the
  1997.       command once for each tagged file name.
  1998. $XC   The current file name, without its extension or trailing
  1999.       period.
  2000. $XT   The first or next tagged file name, without its extension
  2001.       or trailing period. Like $T, $XT causes the command to
  2002.       be run once for each tagged file name.
  2003.  
  2004.  
  2005.  
  2006.  
  2007.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2008. Macro examples:
  2009.  
  2010.                                   TYPE $C
  2011.  
  2012. Runs the DOS TYPE command on the current file. If the file pointer was on the
  2013. file TV.DOC, the command is executed as:
  2014.  
  2015.                                 TYPE TV.DOC
  2016.  
  2017. which will type (display) the text file to the screen. The command
  2018.  
  2019.                                COPY $T A: /V
  2020.  
  2021. runs the COPY command once for each tagged file. If the files TV.CFG, TV.DOC,
  2022. TV.EXE, and TV.HLP were tagged, the following commands are executed:
  2023.  
  2024.                              COPY TV.CFG A: /V
  2025.                              COPY TV.DOC A: /V
  2026.                              COPY TV.EXE A: /V
  2027.                              COPY TV.HLP A: /V
  2028.  
  2029. When executing a DOS command in the Show-All or Show-Sub modes (multiple
  2030. directories displayed in a single file name window), use the $F or $P macros
  2031. to ensure the command looks for the file in the proper directory. Without the
  2032. $F or $P, the command will most likely assume the file is in the current
  2033. directory, while it may in fact be in a different directory. The command 
  2034.  
  2035.                               FIND "silver" $T
  2036.  
  2037. tries to find the string "silver" in all tagged files, but will not be able to
  2038. search those files that are not in the current directory. The command
  2039.  
  2040.                              FIND "silver" $P\$T
  2041.  
  2042. searches all tagged files using the file's complete pathname (including files
  2043. not in the current directory). To pass a macro name to DOS without being
  2044. expanded, use two $ signs. The command
  2045.  
  2046.                                 COPY *.C $$D /V
  2047.  
  2048. is executed as:
  2049.  
  2050.                                 COPY *.C $D /V
  2051.  
  2052. The macro names can be entered in upper or lower case, thus $C is the same as
  2053. $c.
  2054.  
  2055. Entering a $T or $XT macro on a command line causes Treeview to execute the
  2056. command once for each tagged file in the current window. If you have a RAM
  2057. disk on your computer system, you can speed up such operations by putting a
  2058. copy of the DOS COMMAND.COM file on the RAM disk and pointing the COMSPEC
  2059. environment variable to it. For example, if your system has a RAM disk as
  2060. drive D, the following commands in the AUTOEXEC.BAT would copy the COMMAND.COM
  2061. file and setup the COMSPEC environment variable:
  2062.  
  2063.                           COPY C:\COMMAND.COM D:\
  2064.                           SET COMSPEC=D:\COMMAND.COM
  2065.  
  2066.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2067. 6-3 Setting File Limits
  2068.  
  2069. Treeview allows you to select the maximum number of files that can be
  2070. displayed in a file name window. The number of files per window directly
  2071. corresponds to the amount of your computer's memory required to hold file
  2072. information. The smallest number allowed is 100, while the maximum is 2515.
  2073. Approximately 64K of memory is used to hold file information when the maximum
  2074. value of 2515 is selected. Having four maximum sized windows open at once
  2075. would require 256K of memory just to hold file information.
  2076.  
  2077. If you want to minimize the amount of memory that Treeview itself uses, select
  2078. a value for the number of files per window that is just large enough to hold
  2079. all the files in one of your typical directories. Minimizing Treeview's memory
  2080. usage allows more memory for any programs executed from within Treeview.
  2081.  
  2082. The number of files per window is set with the [Other | Setup Parameters |
  2083. #Files per Window] command. Changing this value does not effect any file name
  2084. windows that are already open, only windows opened afterwards (via F7 or the
  2085. [Window | Open] command), will have the new value.
  2086.  
  2087. The number of files per window can be increased on a temporary basis by
  2088. selecting the new value and then responding with an N to the "Write Changed
  2089. Parameters to Disk (y/N):" prompt.
  2090.  
  2091. Treeview's conventional memory requirement can be greatly reduced if your
  2092. computer has LIM/EMS memory available to hold file information. See Section
  2093. 6-6, USING EMS MEMORY, for more information.
  2094.  
  2095. 6-4 Point-and-Go
  2096.  
  2097. Treeview's Point-and-Go facility provides the ability to operate on files with
  2098. DOS commands or other programs simply by pointing at the file name and
  2099. "executing" the file. Whenever Treeview "executes" a file, it looks at the
  2100. file's extension to determine what processing is required. If the extension is
  2101. .COM, .EXE, or .BAT, the file is treated as a normal DOS executable program
  2102. (.COM or .EXE) or as a batch file command (.BAT). If the file has an extension
  2103. other than .COM, .EXE, or .BAT, Treeview searches a table of user-defined file
  2104. extensions and commands to determine how to process the file. Instead of
  2105. executing the file itself, Treeview performs one or more DOS commands defined
  2106. for files with matching extensions.
  2107.  
  2108. The Point-and-Go commands are most useful when combined with Treeview's
  2109. command macros. These macros allow information such as the current drive,
  2110. directory, and/or file name to be added to the command before it's executed.
  2111. See Section 6-2 "DOS Command Macros" for a complete description of the
  2112. available macros.
  2113.  
  2114. As with User Defined Keys and the [Xecute] commands, you can specify multiple
  2115. DOS commands to be executed in a Point-and-Go entry by separating the commands
  2116. with "^" characters. The following example shows three DOS commands that could
  2117. be given in a Point-and-Go entry. All three commands would be executed, in
  2118. left to right order, when a file with a matching extension is "executed":
  2119.  
  2120.                del $xc.old^rename $xc.bak $xc.old^ws $xc.old
  2121.  
  2122.  
  2123.  
  2124.  
  2125.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2126. As an example of how to setup the Point-and-Go entries, consider an entry with
  2127. an extension of .DOC and a command of
  2128.  
  2129.                                  WS $C
  2130.  
  2131. Whenever you enter Alt-X (short-cut for [Xecute | Current File]) with the file
  2132. pointer over a .DOC file, Treeview executes the WS program with the current
  2133. file name as a parameter. Alt-X with the file pointer on the file TV.DOC would
  2134. execute the command
  2135.  
  2136.                                WS TV.DOC
  2137.  
  2138. while Alt-X on the file DC_TRIP.DOC would execute the command "WS
  2139. DC_TRIP.DOC".
  2140.  
  2141. The Point-and-Go table can hold up to 10 extension/command entries. You can
  2142. create and modify the entries with the [Other | Setup Parameters | Point and
  2143. Go Setup] command. Each entry can specify from 1 to 3 different extensions.
  2144. When entering multiple extensions, make sure to separate them with a single
  2145. space. The following example shows how several Point-and-Go entries might
  2146. look:
  2147.  
  2148.       NUM   EXT         COMMAND PROTOTYPE      PAUSE  READ
  2149.  
  2150.       1     doc         ws $c                   N     N
  2151.       2     c asm txt   edlin $f                N     N
  2152.       3     ltr         del $xc.bak^ws $c       N     N
  2153.       4     mdf         automake $f             N     N
  2154.  
  2155.  
  2156. Entry number 1 is the WS $C example presented previously. Entry number 2 shows
  2157. a command that edits files with three different extensions (.C, .ASM, and
  2158. .TXT). Entry 3 shows two commands being executed for LTR files, while entry 4
  2159. edits AUTOMENU Menu Definition Files by running the AUTOMAKE program.
  2160.  
  2161. For each Point-and-Go entry, you can define whether or not Treeview pauses
  2162. and/or rereads the current directory after executing the DOS commands. If you
  2163. enter "Y" (for YES) in a entry's PAUSE column, Treeview waits for you to press
  2164. a key after running the command(s). An "N" (for NO) in the PAUSE column causes
  2165. Treeview's screen to be redisplayed as soon as the commands finish. Entering
  2166. "Y" for PAUSE allows you to view any output the commands leave on the screen
  2167. before Treeview redisplays its own screen.
  2168.  
  2169. Entering "Y" in the READ column of an entry tells Treeview to reread the
  2170. current directory when the command(s) finish. A value of "N" will not reread
  2171. the directory. "Y" should most likely be specified if the commands create or
  2172. delete files, or if they change the current directory. Note that rereading the
  2173. directory will result in "untagging" any files tagged before the commands were
  2174. executed. There is a limit of 50 characters to any one Point-and-Go key.
  2175.  
  2176. 6-5 User Defined Keys
  2177.  
  2178. Treeview provides the ability to execute user defined commands at the touch of
  2179. a key. There are 30 User Defined Keys available. A particular User Defined Key
  2180. is executed by pressing an Alt-Function key sequence, a Control-Function key
  2181. sequence, or a Shift-Function key sequence. Alt-F1 executes User Defined Key
  2182. number 1, Alt-F2 executes User Defined Key number 2, and so forth.
  2183.  
  2184.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2185. User Defined Keys are created and modified with the [Other | Setup Parameters
  2186. | User Defined Keys] command. The following sample entries show how User
  2187. Defined Keys are entered.
  2188.  
  2189.       NUM   KEY   COMMAND PROTOTYPE           PAUSE       READ
  2190.  
  2191.       1     A-F1  edlin $f                      N           N
  2192.       2     A-F2  pkzip -v $f                   Y           N
  2193.       3     A-F3  chkdsk $d:                    Y           N
  2194.  
  2195. The first entry (invoked by the Alt-F1 sequence) runs the program EDLIN with
  2196. the name of the current file as a parameter. Assuming EDLIN is a text editor,
  2197. you could edit any text file by moving the file pointer to the file's name and
  2198. pressing Alt-F1.
  2199.  
  2200. The second entry shown above runs the program PKZIP with two parameters; the
  2201. letter V and the name of the current file. PKZIP is a popular program for
  2202. maintaining compressed files. Moving the file pointer to a .ZIP file and
  2203. pressing Alt-F2 would list (view) the contents of the .ZIP file.
  2204.  
  2205. The third entry shown above runs the DOS CHKDSK command with the current drive
  2206. letter as a parameter.
  2207.  
  2208. As with Point-and-Go entries and the [Xecute] commands, you can specify
  2209. multiple DOS commands to be executed by a User Defined Key. Each command must
  2210. be separated from the others by the '^' character. The following example shows
  2211. two DOS commands that can be executed by a User Defined Key:
  2212.  
  2213.                          del $xc.bak^edlin $c
  2214.  
  2215. For each User Defined Key, you can specify whether or not Treeview pauses
  2216. and/or rereads the current directory after executing the commands. If you
  2217. enter "Y" (for YES) in a command's PAUSE column, Treeview waits for you to
  2218. press a key after running the command(s). An "N" (for NO) in the PAUSE column
  2219. causes Treeview's screen to be redisplayed as soon as the commands finish.
  2220. Entering "Y" for PAUSE allows you to view any output the commands leave on the
  2221. screen before Treeview redisplays its own screen.
  2222.  
  2223. Entering "Y" in the READ column of an entry tells Treeview to reread the
  2224. current directory when the commands finish. A value of "N" will not reread the
  2225. directory. "Y" should most likely be specified if the commands create or
  2226. delete files, or if they change the current directory. Note however that
  2227. rereading the directory will "un-tag" all files which were tagged before the
  2228. commands were executed. There is a limit of 50 characters in any one User
  2229. Defined Key.
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2244. 6-6 Using EMS Memory
  2245.  
  2246. Treeview can make use of two different types of memory in your computer system
  2247. - conventional and expanded. Conventional memory is that part of memory used
  2248. and controlled by DOS. Normally there is somewhere between 128K and 640K of
  2249. conventional memory available in an IBM PC or compatible system. The
  2250. Lotus/Intel/Microsoft (LIM) Expanded Memory Specification (EMS) is a hardware
  2251. and software system that provides extra (expanded) memory to programs that are
  2252. able to access it. If your computer system has EMS compatible memory
  2253. installed, Treeview can use this memory to store file names and other file
  2254. data. Allowing Treeview to utilize EMS memory is advantageous because it
  2255. leaves additional conventional memory available to execute DOS commands and
  2256. other programs from Treeview.
  2257.  
  2258. The [Other | Setup Parameters | Other Options | Use EMS (if available)] option
  2259. enables or disables Treeview's use of LIM/EMS memory. If your computer system
  2260. does not have LIM/EMS memory installed, this option has no effect since
  2261. Treeview will then use conventional memory. The [Other | Setup Parameters |
  2262. Other Options | Use EMS (if available)] option is turned on when a check mark
  2263. is displayed in front of the option; it's off when a "not sign" (-) precedes
  2264. the option.
  2265.  
  2266. You can also enable or disable Treeview's use of EMS memory with the /C and /E
  2267. command line parameters. Refer to Section 3-1, Command Line Parameters, for
  2268. more information.
  2269.  
  2270. Remember: if you want the changes you make to become permanent, be certain to
  2271. save the new values to disk when prompted. By default, Treeview considers all
  2272. changes made to be temporary, so if you wish the changes to become the new
  2273. defaults, you MUST save them.
  2274.  
  2275. As distributed, the [Use EMS (if available)] option is on to allow Treeview's
  2276. use of EMS memory - if EMS memory isn't available, conventional memory will be
  2277. used anyway.
  2278.  
  2279. 6-7 Video Snow Checking
  2280.  
  2281. Video "snow" is best described as little flashes of light on your monitor
  2282. screen. Sometimes caused by clone CGA video cards, snow is a distracting
  2283. nuisance that can be avoided by setting Treeview to write to the screen
  2284. through the BIOS, instead of directly to video memory.
  2285.  
  2286. The [Other | Setup Parameters | Other Options | Video Snow Checking] option
  2287. allows for faster screen updates on computer systems that do not make "snow"
  2288. when writing directly to video memory. This option is only useful for some
  2289. systems with color displays--monochrome displays do not make "snow" and
  2290. Treeview will NOT check for snow when using a monochrome adapter.
  2291.  
  2292. Disabling "snow" checking can significantly speed up screen updates. If you
  2293. are not sure if your color display adapter makes snow or not, try disabling
  2294. Treeview's snow checking. It will quickly be obvious if you need to re-enable
  2295. the snow checking.
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2303. Snow checking is enabled when a check mark is displayed before the [Other |
  2304. Setup Parameters | Other Options | Video Snow Checking] option. Snow checking
  2305. is disabled when a "not sign" (-) is displayed. You can also enable or disable
  2306. snow checking with the /F and /S command line parameters. Refer to Section
  2307. 3-1, COMMAND LINE PARAMETERS, for more information. As distributed, video snow
  2308. checking is disabled.
  2309.  
  2310. 6-8 Defining the Editor and Viewer
  2311.  
  2312. Treeview permits you to specify your own file listing (viewing) utility as
  2313. well as an editor. Even though a native file viewer is included, you might
  2314. wish to use the famous LIST program to view your files. To do this from the
  2315. main Treeview screen you would press Alt-S (for Setup), "H" for External
  2316. Program Hooks, and "V" to specify that you want to change the File Viewer.
  2317.  
  2318. You will be asked for a "command prototype". This is the specification to tell
  2319. Treeview what listing program to run and what form of filename to use with it
  2320. in the form of a DOS Command Macro. For example:
  2321.  
  2322.                                  LIST $F
  2323.  
  2324. will instruct Treeview to use Vern Buerg's fine LIST program and pass to it
  2325. the current file including pathname ($F) and display it on the screen. More
  2326. details on the concept of DOS Macros are in Section 6-2. Available macros are
  2327. listed in Appendix D. A user defined editor would be defined in exactly the
  2328. same way, except you would specify "E" for File Editor and input the "command
  2329. prototype" for the editor.
  2330.  
  2331. 6-9 DOS Volume Labels
  2332.  
  2333. You can change the name of the DOS volume label on your disk drive with this
  2334. special capability of Treeview. From the main display screen, type "O" for
  2335. Other and "L" for Set Volume Label. Input the new name and press Enter. The
  2336. new volume name will be displayed on the main screen.
  2337.  
  2338. 6-10 DOS Verify
  2339.  
  2340. Treeview can control the DOS verify function by turning it on or off. The
  2341. Verify function performs a check every time a file is copied to make certain
  2342. (verify) that the operation occurred successfully. Copying files will take a
  2343. bit longer with verify turned on because of the checks that must be performed,
  2344. however it is almost certain that many file related problems will not be
  2345. noticed if the verify function is left on.
  2346.  
  2347. If you use an exceptionally slow disk drive or CPU, you might be forced to
  2348. leave verify OFF due to the length of time required to copy files. We
  2349. recommend, however, that the DOS verify function be left ON at all times.
  2350. Think of it as a little piece of insurance - a little peace of mind.
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2362. SECTION 7
  2363. SHAREWARE CONSIDERATIONS
  2364.  
  2365. Treeview is distributed under the shareware marketing concept - it is NOT free
  2366. software and it HAS NOT been released to the public domain. The documentation,
  2367. executable images, and all other files distributed with Treeview are
  2368. copyrighted by Magee Enterprises, Inc.
  2369.  
  2370. 7-1 What is Shareware?
  2371.  
  2372. Shareware is a way of distributing computer software that allows you to try
  2373. out a program before you purchase it. Programs distributed as Shareware
  2374. typically give you some period of time to use the program and evaluate its
  2375. usefulness to you. If the program doesn't meet your needs, you're under no
  2376. obligation to pay for it. If you do find the program useful and wish to
  2377. continue using it, the Shareware program's author will request that you pay
  2378. for the program by sending him or her a completed registration form and
  2379. payment.
  2380.  
  2381. If you find Treeview to be a useful addition to your software library, please
  2382. become a registered user by completing the enclosed registration form and
  2383. returning it along with the indicated license/registration fee. We hope that
  2384. you will agree that the registration fee is a small price to pay for the
  2385. continued use of the program. It requires a large investment to develop,
  2386. market, and support a product of this complexity. Your support in the form of
  2387. a registration payment will help us to continue to make good software
  2388. available at very reasonable prices. Treeview is also available at very
  2389. special rates to organizations who wish to use it in promotional campaigns, or
  2390. to educational institutions. Call or write to Magee Enterprises, Inc. for more
  2391. information.
  2392.  
  2393. 7-2 How to Register
  2394.  
  2395. If you use Treeview on a regular basis, you should print out and complete the
  2396. file REGISTER.FRM and return it along with the indicated license/registration
  2397. fee. Registration gives you the right to use the software as documented in
  2398. the license. There are two types of registrations available:  1) regular, and
  2399. 2) quantity. 
  2400.  
  2401. The reasonable registration fee establishes you as a registered user of
  2402. Treeview and upon our receipt , you will be mailed a diskette containing the
  2403. most recent Treeview version, a printed manual, extended technical support,
  2404. notice of product updates, and our multiple line, 24 hour networked bulletin
  2405. board service (The Big Peach BBS). Note that the version mailed to you may be
  2406. the same version you already have, although updated versions will be released
  2407. from time to time. 
  2408.  
  2409. Registered users will also receive the current release of TV286, a version of
  2410. Treeview specifically made for computers with the Intel 80286 and 80386
  2411. microprocessors, as well as all the above mentioned materials.
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2421. APPENDIX A
  2422. TREEVIEW MENU STRUCTURE
  2423.  
  2424. Main Menu Line
  2425. ===============================================================
  2426. Dir  Files  Help  Other  Sort  Tag/Untag  Windows  Xecute  Quit
  2427. ===============================================================
  2428.  
  2429. DIR
  2430.  
  2431.       L     Login New Directory                             Alt-L
  2432.       D     Login New Drive                                 Alt-G
  2433.       R     Reread Current Dir                              Alt-N
  2434.       T     Show Directory Tree                             Alt-T
  2435.       A     Show All Dirs
  2436.       S     Show Sub Dirs
  2437.       U     Update Target Directory
  2438.       X     Update Existing Files Only
  2439.  
  2440. FILES
  2441.  
  2442.       A     Set File Attributes
  2443.                   C     Current File                        Alt-A
  2444.                   T     Tagged Files                        Alt-B
  2445.  
  2446.       C     Copy Files
  2447.                   C     Current File                        Alt-C
  2448.                   T     Tagged Files                        Alt-K
  2449.                   R     Use DOS Verify
  2450.                   I     Overwrite Check
  2451.  
  2452.       D     Set File Date/Time
  2453.                   C     Current File
  2454.                   T     Tagged Files
  2455.  
  2456.       F     Edit File                                       Alt-F
  2457.  
  2458.       E     Erase Files
  2459.                   C     Current Files                       Alt-E
  2460.                   T     Tagged Files                        Alt-Y
  2461.  
  2462.       I     Extra File Info                                 Alt-I
  2463.  
  2464.       R     Rename/Move Files
  2465.                   C     Current File                        Alt-R
  2466.                   T     Tagged Files                        Alt-M
  2467.  
  2468.       V     View File                                       Alt-V
  2469.  
  2470.       X     Execute File                                    Alt-X
  2471.  
  2472. HELP (See Appendix B)
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2480. OTHER
  2481.  
  2482.       C     Selection Criteria
  2483.                   A     by Attribute
  2484.                   R     Reset to Defaults
  2485.                   M     File Name Mask
  2486.                   C     Clear Mask
  2487.                   I     Invert Mask
  2488.  
  2489.       I     Treeview Information
  2490.  
  2491.       L     Set Volume Label
  2492.  
  2493.       S     Setup Parameters                                Alt-S
  2494.                   C     Screen Colors
  2495.                   F     # Files per Window
  2496.                   P     Point and Go Setup                  Alt-P
  2497.                   U     User Defined Keys                   Alt-U
  2498.                   S     Startup Defaults
  2499.                   A     Selection Attributes
  2500.                   S     Sort Options
  2501.                         B     Bypass Startup Screen Wait
  2502.                         1     Extra File Info (1 column)
  2503.                         2     Extra File Info (2 columns)
  2504.  
  2505.                   T     Copy Options
  2506.                         D     Use DOS Verify
  2507.                         O     Overwrite Check
  2508.  
  2509.                   D     Dir Tree Options
  2510.                         D     Select Drives to Always Write
  2511.                         P     Prompt to Write when changes
  2512.  
  2513.                   H     External Program Hooks
  2514.                   E     File Editor
  2515.                   V     File Viewer
  2516.  
  2517.                   V     View Options
  2518.                   7     Display 7 Bit Char
  2519.                   M     Require Case Match
  2520.                   A     Default to ASCII
  2521.                   H     Default to Hex
  2522.                   O     Other Options
  2523.                         D     Display as NAME     EXT
  2524.                         E     Use EMS Memory
  2525.                         F     Sound Effects
  2526.                         M     Use Mouse (if available)
  2527.                         S     Video Snow Checking
  2528.                         4     Use EGA 43/VGA 50 Line Mode
  2529.                         X     Esc Exits at Top Level
  2530.  
  2531.                   W     Write Setup to Disk
  2532.  
  2533.       V     Toggle DOS Verify
  2534.  
  2535.  
  2536.  
  2537.  
  2538.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2539. SORT
  2540.  
  2541.       N     by Name
  2542.       E     by Extension
  2543.       D     by Date
  2544.       S     by Size
  2545.       U     Unsorted
  2546.       A     Ascending
  2547.       C     Descending
  2548.  
  2549.  
  2550. TAG/UNTAG
  2551.  
  2552.       C     Current File
  2553.       D     Date/Time
  2554.       I     Invert
  2555.       M     Modified
  2556.       N     by Name
  2557.       T     Today
  2558.       U     Untag All
  2559.       S     Select Tagged
  2560.  
  2561. WINDOWS
  2562.  
  2563.       O     Open                                            F7
  2564.       C     Close                                           F8
  2565.       E     Expand
  2566.       N     Next                                            F9
  2567.       P     Previous                                        F10
  2568.  
  2569. XECUTE
  2570.  
  2571.       C     Current File                                    Alt-X
  2572.       D     DOS Command                                     Alt-D
  2573.       S     DOS Shell
  2574.  
  2575. QUIT                                                        Alt-Q
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2598. APPENDIX B
  2599. TREEVIEW HELP STRUCTURE
  2600.  
  2601. HELP
  2602.  
  2603.       C     Commands
  2604.                   D     Directories
  2605.                         D     Dir-Tree
  2606.                         S     Show All/Sub
  2607.                         U     Update
  2608.  
  2609.                   F     Files
  2610.                         A     Attributes
  2611.                         C     Copy
  2612.                         D     Date/Time
  2613.                         I     Info
  2614.                         V     View
  2615.                               F     Find
  2616.  
  2617.                         X     Execute
  2618.  
  2619.                   O     Other
  2620.                         C     Criteria
  2621.                         S     Setup
  2622.                               C     Colors
  2623.                               D     Defaults
  2624.                                     A     Attributes
  2625.                         F     Files
  2626.                         G     Go
  2627.                         U     User Defined Keys
  2628.                         S     Snow Checking
  2629.                         O     Options
  2630.  
  2631.                   S     Sort
  2632.                   T     Tag
  2633.                   W     Windows
  2634.                               O     Open/Close
  2635.  
  2636.                   X     Execute
  2637.                               G     Go
  2638.                               M     Macros
  2639.       
  2640.       I     Input
  2641.                   K     Keyboard
  2642.                               A     Alt
  2643.                               C     Control
  2644.                               F     Function
  2645.                               O     Other
  2646.                   M     Mouse
  2647.  
  2648.       M     Menus
  2649.       P     Parameters
  2650.       R     Registration
  2651.       S     Screen
  2652.       Q     Quit
  2653.  
  2654.  
  2655.  
  2656.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2657. APPENDIX C
  2658. TREEVIEW KEYSTROKE COMMANDS
  2659.  
  2660.  
  2661.       Function Key Usage
  2662.  
  2663.  
  2664. F1    Help
  2665.  
  2666. F2    Tag/Untag current file (toggle)
  2667.  
  2668. F3    Login to parent directory
  2669.  
  2670. F4    Login to subdirectory under pointer
  2671.  
  2672. F5    Goto next tagged file (find NEXT in View)
  2673.  
  2674. F6    Goto previous tagged file (find PREVIOUS in View)
  2675.  
  2676. F7    Open another file display window
  2677.  
  2678. F8    Close current file display window
  2679.  
  2680. F9    Goto next filename display window
  2681.  
  2682. F10   Goto previous filename display window
  2683.  
  2684.  
  2685.  
  2686.  
  2687.                                     Control Key Usage
  2688.  
  2689.     [Note: "^R" means to hold down the Control key and press the letter R.]
  2690.  
  2691. ^R          PageUp
  2692. ^C          PageDown
  2693. ^W, ^E      Up Arrow
  2694. ^Z, ^X      Down Arrow
  2695. ^A, ^S      Left Arrow
  2696. ^D, ^F      Right Arrow
  2697. ^G          Delete
  2698. ^V          Insert
  2699. ^H          Backspace
  2700. ^M          Enter
  2701. ^T          Tag, Untag current file
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2716.             Other Keys Used in Treeview
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722. =           Find File in current window
  2723.  
  2724.  
  2725. +           Tag Current File in window
  2726.  
  2727.  
  2728. -           Untag Current File in window
  2729.  
  2730.  
  2731. *           Access last used menu item
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2775. APPENDIX D
  2776. DOS COMMAND MACROS
  2777.  
  2778. Macro Substitution
  2779.  
  2780.  $C   Filename with extension
  2781.  
  2782.  $D   Drive letter, no trailing colon (:)
  2783.  
  2784.  $F   Full pathname (drive, directory, filename and extension)
  2785.  
  2786.  $P   Directory pathname, no trailing colon (:)
  2787.  
  2788.  $T   First or next tagged filename (executes once per file)
  2789.  
  2790.  $XC  Filename, no extension or trailing period
  2791.  
  2792.  $XT  First or next tagged filename, no extension or trailing period
  2793.       (like $T, executes once per file)
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.               Examples of Command Prototypes using DOS Macros
  2800.  
  2801.                      (50 Characters maximum length)
  2802.  
  2803.  
  2804. del $xc.old^ren $xc.bak $xc.old^ws $xc.old
  2805. (Delete a file, then rename the backup file and edit it)
  2806.  
  2807.  
  2808. echo $t >> dirs^pkzip -a zipfile @dirs^del dirs
  2809. (Copy each tagged filename into a file called DIRS, then create a compressed
  2810. file from that list and then delete the list)
  2811.  
  2812.  
  2813. command [parameter(s)]^command [parameter(s)]^command ...
  2814. (Generic implementation of multiple DOS commands )
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2834. APPENDIX E
  2835. CUSTOMER SUPPORT INFORMATION
  2836.  
  2837. If you have problems with Treeview, please read this manual first to make sure
  2838. you do understand everything. We have tried to provide a bug-free product but
  2839. sometimes we make mistakes. If you think you have found something please take
  2840. the time to contact us and explain it to us. Make sure that you include the
  2841. following information to help us evaluate your situation:
  2842.  
  2843. 1.          Your product SERIAL NUMBER (Registered Users have serial numbers)
  2844. 2.          Version of DOS you are using
  2845. 3.          Machine type, memory, monitor type, hardware description
  2846. 4.          Any application executed before Treeview
  2847. 5.          Your address and telephone number (when corresponding)
  2848. 6.          Where, when and how you obtained Treeview
  2849. 7.          Which version of Treeview you are using
  2850. 8.          Printouts of your AUTOEXEC.BAT and CONFIG.SYS files
  2851.  
  2852. We also provide a networked electronic Bulletin Board System (BBS) for anyone
  2853. interested in Treeview, Automenu(R), or Shareware in general. This board
  2854. currently supports 1200, 2400, and 9600 baud (Hayes) speeds and is available
  2855. 24 hours a day, seven days a week. Multiple lines are now available, however
  2856. in the future we will offer some lines that are limited to registered users
  2857. only.
  2858.  
  2859. We maintain the most current releases of our products and many other helpful
  2860. files concerning Treeview and Automenu, as well as a large selection of other
  2861. Shareware products provided to us directly from the authors. The BBS can be
  2862. reached by calling 404-446-6650. We also can be reached through a CompuServe
  2863. ID: 76004,1541. Our Technical Support Group is open between the hours of 9am
  2864. and 4pm Eastern Time, Monday through Friday, and their direct line is
  2865. 404-662-5387. We also have a 24 hour FAX line available at 404-368-0719.
  2866.  
  2867. Users will always receive a response to their questions. Non-registered users
  2868. will receive a written response if they enclose a self-addressed, stamped
  2869. envelope with their inquiry.
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2893. APPENDIX F
  2894. TREEVIEW AND THE DISK OPERATING SYSTEM (DOS)
  2895.  
  2896. Treeview is a sophisticated, powerful software tool, and as such requires a
  2897. bit of knowledge on the part of the user. In fact, the more you understand
  2898. about the DOS, the better you will be able to use Treeview.
  2899.  
  2900. WHAT IS DOS?
  2901.  
  2902. DOS is really SOFTWARE for the computer that allows it to deal with disk
  2903. drives, both floppy and fixed (hard drives). The computer is actually a very
  2904. "dumb" appliance, and can only function in the manner prescribed by the user.
  2905. By starting up the PC, DOS will load automatically, and then tell you that it
  2906. is ready for further instructions. Typically, most garden-variety computers
  2907. show a "prompt" (ready to do something) such as this one:
  2908.  
  2909. C:\>
  2910.  
  2911. Let's face it - it doesn't take a rocket scientist to know that this prompt is
  2912. anything but friendly. How can you know what to do next when the computer
  2913. won't show you your choices?
  2914.  
  2915. DOS is really a collection of programs, and that's why we refer to it as a
  2916. "system" - there is more than one element to it. DOS starts to work each time
  2917. you "boot" (power up) your machine, loading a pair of hidden files (they are
  2918. not shown in a DIRectory listing) and then checking for a couple of more
  2919. (CONFIG.SYS and AUTOEXEC.BAT), and if they exist, they are loaded into memory
  2920. and we are off and running!
  2921.  
  2922. Of course, DOS is of no use whatsoever without a computer that can run it. You
  2923. might say that there is a very close relationship between DOS and the computer
  2924. - without each, the other would be useless. That's why you usually receive a
  2925. copy of DOS whenever you purchase a new PC. In a real sense, DOS is THE most
  2926. important program your computer can run!
  2927.  
  2928. HOW DOES DOS WORK?
  2929.  
  2930. We can classify the general operations of any computer in four simple steps:
  2931.  
  2932. INPUT
  2933.  
  2934. PROCESS
  2935.  
  2936. STORAGE
  2937.  
  2938. OUTPUT
  2939.  
  2940. This is what we are going to call the "IPSO Facto". All computer operations
  2941. can be broken down into one of the above, and if we try to categorize all the
  2942. things we do with our PCs, we will find that they fall into one of these
  2943. areas. For instance, when we turn on our computer, and it sits there waiting
  2944. for us to do something, we could say that it is ready to accept INPUT. When we
  2945. type a command that the computer recognizes, we say that it is PROCESSing that
  2946. request. If we save a file, STORAGE comes into play, and whenever we print
  2947. something, or display anything on the monitor, we are using the computer's
  2948. OUTPUT function.
  2949.  
  2950.  
  2951.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  2952. Most everything that the PC can do will be able to be classified under one (or
  2953. more) of the above headings. Even programmers can make life much easier for
  2954. themselves by organizing their particular language into this kind of
  2955. arrangement.
  2956.  
  2957. WHY IS FILE MANAGEMENT SO IMPORTANT?
  2958.  
  2959. Treeview was designed to help in the process of dealing with all the files
  2960. that can be generated by the OUTPUT process mentioned above. When you run
  2961. programs, files are usually created (or changed). Take your word processor
  2962. (WP), for example. When you run it, it asks for the name of the file to be
  2963. edited and opens it. If you wish to create a new file, then the word processor
  2964. creates (OUTPUTs) a new one. If you change a file, some WP programs will leave
  2965. the original file on the disk and simply rename it. When you save the file, it
  2966. is written (OUTPUT) to the disk drive.
  2967.  
  2968. After a while, we could have a serious number of files on our hands - and
  2969. that's just from the word processor! If you use a spreadsheet program, or a
  2970. graphics program, or a database program, the same might be true. Files, files,
  2971. files. What are we going to do with all of them? Well, for starters, we need
  2972. to organize them!
  2973.  
  2974. WHAT IS A DIRECTORY?
  2975.  
  2976. Because the typical hard drive is capable of storing so much data, we need
  2977. some easy method of sorting and organizing the files that are there. DOS has
  2978. an important capability to create "logical" divisions on the disk called
  2979. directories, and to keep track of what is called the "current directory". The
  2980. current directory is very simply the one you are in at any given moment.
  2981.  
  2982. If you can imagine a file cabinet that has only one drawer, you begin to see
  2983. what we are talking about. One large drawer in a cabinet really has no way to
  2984. separate the mass of materials that will be STOREd there, so we use more than
  2985. one drawer to keep logically similar data in the same place. Think of these
  2986. "drawers" as directories, and the entire hard drive as a filing cabinet. If we
  2987. then further break down each drawer into file folders, we begin to simulate
  2988. the same structure that DOS uses to keep track of all the files on the disk.
  2989.  
  2990. If you ran a business, you would file similar paperwork together and create a
  2991. filing system that allowed you (or anybody else) to access any of that
  2992. paperwork in a fast and efficient manner. Similarly, the DOS filing structure
  2993. employs directories (and SUBdirectories) to keep apart different files, and to
  2994. keep together related ones. When we speak about DOS directories, we should
  2995. envision a kind of "tree" structure that begins at the "root" and branches out
  2996. into a variety of directories (and SUBdirectories, which are directories
  2997. underneath other directories). This is how Treeview got it's name - it helps
  2998. manage the tree structure of your disk and keeps all the "leaves" (files)
  2999. swept up and in neat order.
  3000.  
  3001. Your hard disk may be organized, and it may not be, however one thing is
  3002. certain: the more order you keep on your computer's disk, the easier it is to
  3003. make BACKUPS (copies) that can be a real life saver if there is a hardware
  3004. problem (disk crash, for example). The benefits of proper disk organization
  3005. are many and great. Take some time and use Treeview to display the structure
  3006. of your disk drive. Is there a "tree" there? Are similar files grouped into
  3007. individual areas (directories)?
  3008.  
  3009.  
  3010.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  3011. We cannot begin to explain all the intricacies and inner workings of DOS here,
  3012. so we must advise you to take a look at your DOS manual or one of the books
  3013. listed below. The time you invest in learning about your computer's most
  3014. important software will be worth it many times over. Also check into your
  3015. local computer club or user's group - they are a tremendous resource for
  3016. getting answers to questions you might have. In fact, there are answers
  3017. waiting for questions at the next meeting of many, many computer groups, so
  3018. take advantage of the situation, and learn more about DOS.
  3019.  
  3020. RECOMMENDED READING FOR DOS USERS
  3021.  
  3022. There are many good books on using the hidden powers of the Disk Operating
  3023. System, and if you want additional background on using and learning DOS, try
  3024. one or more of these fine volumes:
  3025.  
  3026. RUNNING MS-DOS (3rd Ed.), Van Wolverton, Microsoft Press
  3027.  
  3028. This is probably the very best of the "aftermarket" DOS books, not just
  3029. because it's published by Microsoft, but because Van has taken an easy going,
  3030. almost casual approach to teaching the fundamentals of DOS. He begins by
  3031. explaining what DOS is, how it gets the computer started, and how it organizes
  3032. files and disks (hence it's name: Disk Operating System). He then goes into a
  3033. very understandable explanation of managing files and devices, hard disk
  3034. organization, system controls and tailoring, local area networks and more.
  3035. Several appendices are included, one that tells how to prepare a hard disk and
  3036. another that details the syntax of every DOS command. This is the best book
  3037. for the first time DOS user. Highly Recommended!
  3038.  
  3039. SUPERCHARGING MS-DOS, Van Wolverton, Microsoft Press
  3040.  
  3041. As a follow-up to the title above, Van takes the DOS user deeper into the
  3042. system functionality with chapters on things like printer "languages", using
  3043. the DOS DEBUG utility, controlling the environment with CONFIG.SYS, system
  3044. customizations, care and feeding of the computer, and much more. A Quick
  3045. Reference section is set up to answer questions about ANSI.SYS drivers and
  3046. hexadecimal codes. Definitely NOT for the beginner, SUPERCHARGING is still one
  3047. of the "must-have" books in any DOS user's library. Also Highly Recommended!
  3048.  
  3049. MS-DOS BIBLE, Steven Simrin, The Waite Group
  3050.  
  3051. Also geared for the beginners, this volume stretches the technical side a bit
  3052. more than RUNNING MS-DOS, and even includes a tutorial on booting DOS,
  3053. formatting diskettes, installing and changing drives, filenames and
  3054. extensions, copying files, batch files, redirection and piping, EDLIN (the DOS
  3055. line or text editor), and much, much more! This one is definitely for those
  3056. who have a foundation of knowledge in DOS, and will take you even further than
  3057. the SUPERCHARGING MS-DOS mentioned above. A fine reference work for daily use,
  3058. this book will provide many hours of ready information on all aspects of DOS.
  3059. Recommended.
  3060.  
  3061. TRICKS OF THE MS-DOS MASTERS, The Waite Group
  3062.  
  3063. For users with a previous knowledge of DOS, TRICKS will show you insight and
  3064. techniques not published anywhere else. According to the authors (four of
  3065. them!), this volume is for serious business and personal users, software
  3066. developers and consultants, and "power users". This book will open your eyes
  3067. to some of the more arcane tips and practices for stretching DOS to the max.
  3068.  
  3069.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc.
  3070. MS-DOS BATCH FILE PROGRAMMING, Ronny Richardson, Tab Books
  3071.  
  3072. This is a definitive reference to those who wish additional insight into the
  3073. mysteries of programming directly within the operating system (DOS).
  3074. Everything from simple batch files to replaceable parameters, looping and
  3075. control flow, and the AUTOEXEC.BAT and CONFIG.SYS files are covered. A
  3076. reference to DOS commands is included, and many examples are used throughout.
  3077. If you are DOS-literate, this volume will certainly assist in creating more
  3078. imaginative and powerful batch procedures that will be easily controlled from
  3079. within TREEVIEW or AUTOMENU. Recommended.
  3080.  
  3081. This is definitely NOT intended as any kind of complete resource listing of
  3082. available DOS publications. You should refer to a local PC Users Group for the
  3083. best advice. And keep checking the Magee Enterprises BBS (The Big Peach) for
  3084. updated information and tips and tricks on using DOS and Treeview.
  3085.  
  3086. MS-DOS is a registered trademark of Microsoft Corporation. Treeview is a
  3087. trademark of Magee Enterprises, Inc. Automenu is a registered trademark of
  3088. Magee Enterprises, Inc. All rights are reserved worldwide.
  3089.  
  3090. The above listing is only provided as a public service, and Magee Enterprises
  3091. Inc. is in no way connected or involved with any of the above companies,
  3092. authors or publications. We do, however, feel that in the interests of
  3093. furthering knowledge about computers and DOS in general, it is necessary to
  3094. provide some kind of reference listing for our user's further investigation
  3095. and comprehension.
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.         Treeview 1.1    Copyright 1988,1989 Magee Enterprises, Inc. .End of Treeview Documentation.
  3129.